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PREFACE 


This  thesis  Mas  primarily  concerned  Mith  the  design  and  Implementa¬ 
tion  of  a  Computer  Aided  Design  (CAD)  tool  for  use  In  the  representation 
of  the  physical  layout  of  Very  Large  Scale  Integrated  Circuits  In  the 
Caltech  Intermediate  Form  on  a  microcomputer  using  the  CP/H  operating 
system  (64IC  maximum  memory).  It  provided  me  with  the  experience  of 
working  on  a  large  software  project  and  showed  me  the  rate  at  which 
programs  can  grow  In  size  while  adding  only  simple  functions. 

HOCLL  Is  designed  to  operate  very  similar  to  the  chip  layout  lan¬ 
guage  CLL.  developed  by  Tim  Saxe  (15).  In  fact,  all  statements  In  the 
HOCLL  system  are  taken  from  CLL.  The  only  difference  between  CLL  and 
HOCLL  Is  that  HOCLL  uses  a  menu  to  obtain  the  Information  for  represen¬ 
ting  the  cell  layout  and  doesn't  Implement  all  the  functions  of  CLL 
(this  Is  one  of  the  downfalls  of  HOCLL  and  should  be  corrected  In  the 
future). 

Thanks  are  offered  to  Lt  Col  Harold  Carter,  my  thesis  advisor,  for 
persuading  me  to  accept  this  challenging  topic  and  seeing  me  through  its 
development.  Also,  thanks  go  to  my  wife  Sandra  for  putting  up  with  me 
while  I  worked  on  this  project. 


Steven  C.  Horrese 


•  s.  m  It  W  r 
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ABSTRACT 


The  Henu  Driven  Chip  Layout  Language  (HDCLL;  pronounced  Doctor 
Chill)  Is  a  microcomputer-based  design  tool  used  for  representing  the 
physical  layout  of  Integrated  circuit  designs  in  the  Caltech  Interme¬ 
diate  Form  (CIF).  HDCLL  is  based  on  the  Chip  Layout  Language  (CLL) 
created  by  Tim  Saxe  of  Stanford  University  and  as  modified  at  the  Air 
Force  Institute  of  Technology.  HDCLL  leads  the  user  through  Interactive 
menu  driven  functions,  allowing  the  user  to  represent  a  circuit  design 
In  CIF;  however,  the  user  sees  a  language  similar  to  CLL  even  though  the 
file  Is  stored  on  disk  as  CIF.  The  output  CIF  file  Is  suitable  for  use 
with  other  Computer  Aided  Design  (CAD)  tools  (e.g.  HCIFPLOT)  or  for  use 
in  the  fabrication  process. 

HDCLL  uses  a  cel  1 -oriented  design  methodology  In  which  the  user 
defines  cells,  and  then  the  user  combines  these  cells  with  the  necessary 
interconnects  to  form  the  layout  of  an  entire  Integrated  circuit.  Cell 
Interconnections  are  presently  possible  by  placing  wires,  abutting 
cells,  or  by  overlapping  two  cells.  In  future  versions  the  cell  overlap 
method  should  produce  a  warning  to  the  user  If  the  cells  overlap  on  more 
than  Just  their  predefined  port  Interfaces.  Another  future  enhancement 
would  be  to  allow  the  Interconnection  of  cells  by  the  use  of  common 
naming  of  predefined  ports. 

The  main  functions  of  HDCLL  are  to  create  a  new  cell,  delete  a 


cell,  place  a  cell,  move  a  cell,  modify  a  cell.  Interconnect  cells,  and 
print  the  CIF  file  of  a  cell. 


1 .  Introduction 


1.1  Background. 

This  thesis  deals  with  two  related  Items:  Very  Large  Scale  Inte¬ 
grated  (VLSI)  circuits;  and  microcomputers.  In  the  following,  a  brief 
overview  of  Integrated  circuits  and  their  design  Is  presented  followed 
by  a  look  Into  the  history  of  microcomputers. 

1.1.1  Integrated  Circuits. 

In  1961,  Fairchild  Introduced  the  first  integrated  circuit  (IC). 
This  revolutionary  Item  contained  a  total  of  four  devices  (I.e.  transis¬ 
tors)  (7).  Since  that  time,  the  number  of  devices  per  chip  has  grown 
astronomically  to  where  presently  there  can  easily  be  hundreds  of  thou¬ 
sands  of  devices  on  a  single  chip  (3).  The  first  IC's  were  designed  by 
hand;  the  design  was  then  transferred  to  rubyllth,  and  finally  the 
design  was  checked  for  accuracy  by  hand.  The  rubyllth  pattern  was  then 
optically  reduced  to  form  photolithographic  masks.  The  complexity  of 
the  Integrated  circuits,  however,  was  soon  to  cause  the  engineers  prob¬ 
lems  in  designing  and  testing.  Due  to  the  complexity  involved,  in  the 
late  1960's,  IC  design  and  fabrication  aids  began  to  be  used.  The  first 
assistance  for  the  fabrication  process  to  appear  was  the  numerically 
contrclled  optical  pattern  generating  machine.  This  machine  required 
digitally  encoded  geometric  patterns  and  the  transfer  of  the  layouts  to 
data  tape  by  use  of  electromechanical  digitizers.  This  process  encour¬ 
aged  the  use  of  design  rule  checking  programs  to  detect  short  circuits 
and  spacing  errors  (4).  During  this  period  of  time,  there  was  no  coor- 


process.  Each  manufacturing  facility  Mas  only  concerned  with  their  own 
specific  problems  and  each  tried  solving  the  problems  by  themselves 
(each  no  doubt  trying  to  get  the  competitive  edge  over  the  other). 

A  gap  soon  formed  between  academic  engineering  currlculums  and  the 
needs  of  the  Industry.  This  was  caused  by  advancing  technology  In 
Integrated  circuits.  Universities  soon  saw  the  need  to  not  only  provide 
IC  design  courses  in  their  currlculums,  but  also  the  need  to  perform 
research  In  this  rapidly  growing  technology.  Carver  Head  and  Lynn 
Conway  were  pioneers  In  this  effort.  At  the  California  Institute  of 
Technology,  in  the  early  1970‘s,  they  developed  a  course  for  not  only 
studying  IC  design  methodology,  but  also  for  laying  out  and  testing 
actual  circuits.  In  1978  they  produced  the  first  book  for  use  In  the 
classroom  environment.  It  Is  entitled  Introduction  to  VLSI  Systems,  and 
thus  the  formal  teaching  of  IC  design  methodology  at  the  university 
level  was  started.  (7  and  12) 


1.1.2  Microcomputers. 

Microcomputers  were  first  built  In  the  mid  1960's  by  engineering 
hobbyists  (6).  However,  It  wasn't  until  1974  that  the  first  microcompu¬ 
ter  became  available  commercially  when  the  Sce)b1-8H  was  produced.  The 
response  was  large  and  immediate,  and  the  two  people  originally  manufac¬ 
turing  this  machine  had  to  soon  hire  others.  The  next  computer  to 
become  available  was  the  HITS  Altair  which  was  featured  on  the  front 
cover  of  the  January  1975  Issue  of  Popular  Electronics  (13).  The  next 
Important  event  to  occur  was  the  Introduction  of  the  first  Integrated 


microcomputer  In  mid  1975.  It  was  called  the  Sphere  and  contained  the 
processor,  keyboard,  and  display  all  In  one  case  (1).  In  the  same  year 
(1975)  many  companies  came  out  with  microcomputers. 

During  the  next  ten  years  many  companies  tried  to  compete  In  the 
microcomputer  market,  with  few  surviving  the  competition.  In  1980,  a 
major  breakthrough  In  the  computer  Industry  occurred  when  Sinclair 
(later  bought  out  by  Timex)  marketed  Its  ZX-80,  the  first  computer  sold 
for  under  $200.  In  1981  another  major  Innovation  occurred  when  Osborne 
Introduced  the  first  transportable  computer.  IBH,  seeing  this  new 
market  for  computers.  In  1981  entered  the  microcomputer  world  with  their 
IBH-PC.  Not  to  be  left  behind.  DEC  entered  the  field  In  1982  with  the 
Rainbow  100  and  Professional  325  and  350.  In  1983,  Osborne  Computer 
filed  for  bankruptcy  and.  In  1984,  Timex/Sinclair  and  others  left  the 
market  or  sold  out.  (2)  The  microcomputer  business  has  not  yet  stabi¬ 
lized  and  probably  won't  for  a  few  more  years. 

There  are  two  reasons  for  the  rapid  acceptance  of  the  microcompu¬ 
ter.  One  Is  the  low  cost  of  these  new  personal  computers,  and  the  other 
Is  the  capability  and  flexibility  of  most  of  these  machines.  Microcom¬ 
puters  can  do  such  varied  tasks  as  keeping  track  of  finances  to  control¬ 
ling  heating  and  lighting.  Due  to  this  capability  and  flexibility, 
microcomputers  are  being  tried  In  as  many  different  applications  as 
possible.  One  of  these  applications  Is  Computer  Aided  Design;  the  topic 


of  this  thesis. 


1.2  Problem. 

There  currently  exists  a  number  of  Computer  Aided  Design  (CAD) 
tools  available  for  the  purpose  of  designing  Very  Large  Scale  Integrated 
(VLSI)  circuits.  Host  of  these  tools  are  hosted  on  mainframe  computers 
(e.g.  Caesar)  or  dedicated  minicomputers  (e.g.  the  Apollo  Domain  work- 
stat1on)(5).  This  makes  the  use  of  these  tools  very  expensive.  Due  to 
this  cost,  many  colleges  and  universities  don't  have  any  form  of  "hands- 
on"  VLSI  design  courses  available  for  their  students. 

To  reduce  the  cost  of  VLSI  design.  It  would  be  desirable  to  host  a 
set  of  VLSI  design  tools  on  a  microcomputer  which  would  be  capable  of 
producing  a  file  suitable  for  use  by  the  chip  manufacturing  facilities. 
The  difficulty  with  this  Is  the  lack  of  memory  space  and  processing 
speed  which  would  be  available  on  a  mainframe  or  dedicated  minicomputer. 
The  first  problem  to  overcome  Is  designing  and  Implementing  a  too)  for 
the  physical  layout  of  VLSI  circuits  on  a  microcomputer  (the  specific 
topic  of  this  thesis).  Afterwards,  design  rule  checkers  (for  ensuring 
the  layout  Is  physically  correct)  and  extractors  (to  use  with  logic 
simulation  programs  to  ensure  the  layout  will  function  as  expected)  are 
the  next  tools  to  be  Implemented  on  a  microcomputer. 

1.3  Summary  of  Current  Work. 

Until  recently,  all  Computer  Aided  Design  (CAD)  was  performed  on 
mainframe  computers  or  dedicated  minicomputers.  CAD  tools  are  available 
on  these  machines  due  to  their  large  memory  capacity  and  fast  processing 
speed.  Since  microcomputers  are  becoming  both  more  powerful  In  terms  of 
memory  and  speed  and  more  prevalent,  not  only  In  the  home,  but  also  In 


business  and  educational  Institutions,  CAD  programs  are  being  developed 
for  the  microcomputer.  There  are  two  sources  of  CAD  tools  available. 

CAD  tools  available  In  the  private  domain  (I.e.  commercially  available) 
and  CAD  tools  available  In  the  public  domain  (mostly  In  educational 
Institutions). 

1.3.1  Private  Domain. 

Presently,  most  prevalent  In  the  CAD  area  of  tools  for  the  micro¬ 
computer  are  automated  graphics  packages  such  as  AutoCAD  by  Autodesk 
Incorporated  (Hill  Valley,  CA)  or  3D  Space  Tablet  by  Hicro-Control 
Systems  (Vernon,  CT).  These  are  powerful  graphics  tools  which  can  draw 
practically  anything  (9).  Hore  In  line  with  the  Idea  of  circuit  design 
Is  the  program,  Logicsim,  by  E/Z  Associates  (San  Jose,  CA)  which  assists 
In  printed  circuit  board  layout.  This  program  Includes  a  library  of  not 
only  the  basic  7400  series  TTL  gates,  but  also  some  CD  4000  series  CMOS 
gates  (14).  Another  tool  In  the  area  of  circuit  design  Is  the  STRIDES 
package  by  Futurenet  Corporation  (Canoga  Park,  CA).  This  Is  a  struc¬ 
tured,  Interactive  system,  for  designing  Integrated  circuits.  This 
powerful  system  takes  advantage  of  a  Winchester  disk  drive  (5  and  11). 
Two  other  very  capable  programs  In  the  area  of  circuit  design  are  HICRO- 
CAP,  an  analog  circuit  analysis  program,  and  H1CR0-L061C,  a  digital 
design  and  simulation  system.  Both  of  these  are  by  Spectrum  Software 
(Sunnyvale,  CA)  (18  and  19). 

Unfortunately,  the  programs,  which  are  presently  commercially 
available,  are  for  use  only  down  to  the  gate  level  of  design  (I.e.  HAND, 
NOR,  etc.).  For  designing  VLSI  circuits  a  tool  Is  required  for  describ- 


Ing  the  physical  layout  of  the  transistors  forming  the  circuit.  The 
general  purpose  graphics  packages  described  above  could  be  useful  for 
drawing  VLSI  circuits.  However,  not  being  designed  for  this  purpose, 
their  output  files  would  not  be  compatible  with  existing  tools  (e.g. 
design  rule  checkers),  nor  would  the  output  files  be  usable  In  the 
Integrated  circuit  manufacturing  process. 

With  the  number  of  businesses  and  educational  Institutions  working 
with  VLSI  design,  and  with  microcomputers  becoming  more  commonplace.  It 
Is  easy  to  envision  several  software  companies  marketing  packages  speci¬ 
fically  for  the  design  of  VLSI  circuits  on  microcomputers  In  the  very 
near  future. 

1.3.2  Public  Domain. 

Surprisingly,  little  work  Is  taking  place  In  the  educational  commu¬ 
nity  dealing  with  putting  a  set  of  VLSI  design  tools  on  a  microcomputer. 
This  Is  most  likely  due  to  the  fact  that  most  universities  (e.g.  Univer¬ 
sity  of  California  at  Berkeley)  which  have  the  knowledge  base  needed  to 
perform  VLSI  design  and  create  VLSI  design  tools  already  have  mainframe 
computers  for  their  use  and  will  continue  to  have  abundant  access  to 
these  computers  in  the  future.  Only  four  such  efforts  exist:  1.  The 
effort  here  at  the  Air  Force  Institute  of  Technology  of  not  only  this 
thesis  but  also  the  work  of  Capt.  Kirk  Horton  who  designed  and  Implemen¬ 
ted  a  program  to  perform  checkplots  based  on  a  file  In  the  Caltech 
Intermediate  Form  (7).  2.  A  program  to  print  geometric  files  on  an 

Inexpensive  line  printer  was  developed  by  S.  Sussman-Fort  at  Stoney 
Brook  University.  NY  (17).  3.  Kent  Smith  of  Illinois  University  first 


developed  a  system  for  under  $2000  hardware  which  would  connect  to  a 
minicomputer  host  system  using  a  design  methodology  called  Path  Program¬ 
mable  Logic  (ib>.  nore  recently,  he  has  tried  Implementing  this  type  of 
system  on  a  single  microcomputer  (7).  4.  H.  Israel  and  G.  Noguez  from 

a  University  In  Paris  have  designed  and  Implemented  a  VLSI  CAD  tool 
called  EHILIE2  for  use  on  a  microcomputer  with  a  0.7  HIPS  (million 
Instructions  per  second)  microprocessor.  128K  bytes  of  main  memory,  and 
2  one  Hbyte  floppy  disks  with  0.15  second  access  times.  The  EHILIE2 
system  Includes  a  design  rule  checker,  an  extractor,  a  simulator,  and  a 
plot  program  (8).  One  possible  problem  with  this  system  Is  transporta¬ 
bility  to  other  microcomputers  since  the  microcomputer  on  which  It  Is 
implemented  has  such  high  capabilities.  The  only  other  public  domain 
tool  available  Is  by  Tom  Alamy  of  Tektronics  Corporation.  He  Is 
attempting  to  host  a  set  of  CAD  tools  on  a  TRS-80  (7). 

1.4  Approach. 

The  goal  of  this  thesis  Is  to  Implement  a  menu  driven  form  of  the 
existing  VLSI  CAD  tool  CLL  (15)  on  a  CP/H  (Control  Program  for  Hlcrocom- 
puters)  operating  system  based  microcomputer.  Only  the  basic  function 
of  CLL.  which  is  to  act  as  a  compiler  to  the  Caltech  Intermediate  Form 
(CIF)  of  describing  circuits,  will  be  Implemented.  The  CIF  produced  by 
the  Henu_0r1ven  Chip  Layout  Language  can  then  be  used  by  production 
facilities  to  fabricate  integrated  circuits.  The  output  CIF  file  must 
be  compatible  with  the  program  HCIFPLOT  (7)  and  with  existing  CAD  tools 
(e.g.  the  BANE  preprocessor  hosted  on  the  AFIT  UNIX-VAX  11/780). 


2.1  Overall. 


The  basic  requirement  of  the  Henu  Driven  Chip  Layout  Language 
(HDCLL)  Is  to  allow  easy  (a  relative  term)  development  of  an  Integrated 
circuit  layout  on  a  microcomputer.  It  must  be  compatible  with  the 
Caltech  Intermediate  Form  (CIF)  Version  2.0  (12)  to  allow  production  of 
the  circuit  and  the  use  of  existing  Computer  Aided  Design  (CAO)  tools 
and  existing  CIF  files.  Table  2.1  shows  all  the  CIF  commands,  and 
Indicates  whether  they  will  be  required  or  optional  (nice  to  have  If 
time  permits).  Descriptions  of  geometric  elements  In  non-Hanhattan 
directions  (directions  that  form  other  than  ninety  degree  angles)  will 
not  be  allowed.  These  requirements  will  ensure  compatibility  with  CIF 
files  created  by  the  chip  layout  language  CLL  (15)  and  will  also  ensure 
compatiblluy  with  the  program  HCIFPLOT  (7). 


CIF  Command 


I  Required  I  Optional 


Polygon  with  path  I  I  X 

Box  with  length,  width,  i  I 

center,  and  direction  I  X  I 

Round  Flash  I  X  I 

Hire  with  width  and  path  I  I  X 

Layer  specification  I  X  j 

Start  symbol  definition  I  X  j 

Finish  symbol  definition  I  X  I 

Delete  symbol  definition  I  I  X 

Call  symbol  I  X  | 

Comments  I  X  I 

End  marker  I  X  I 


TABLE  2.1  CIF  commands  to  be  Implemented 


To  obtain  the  most  widespread  use  possible,  HDCLL  must  be  designed 
to  function  on  most  microcomputers.  To  facilitate  this  the  program  will 


be  designed  using  a  CP/H  operating  system  with  64K  of  main  memory  (48K 
Transient  Program  Area)  and  two  180K  disk  drives  (average  5  1/4”  single 
sided,  double  density  floppy  disk).  It  will  be  written  In  the  C  pro¬ 
gramming  language  as  described  In  Kernighan  and  Ritchie  (10)  and  as 
Implemented  by  the  C/80  compiler.  To  allow  HOCLL  to  be  executed  on  as 
many  systems  as  possible  any  system  and  compiler  unique  features  should 
be  avoided.  CP/H  was  chosen  since  It  Is  one  of  the  most  widespread 
standardized  operating  systems  for  microcomputers.  The  C  language  was 
selected  due  to  Its  hierarchical  structure,  standardization,  compact 
assemblage,  and  ability  to  manipulate  low  level  I/O  functions. 

2.3  System. 

The  HOCLL  system  must  be  capable  of  performing  the  following  func¬ 
tions:  create  new  cells  In  CIF;  delete,  place,  or  move  an  existing  cell 
with  relation  to  other  cells;  modify  an  existing  cell  file;  Interconnect 
cells;  and  print  a  CIF  file  or  plot  a  circuit’s  floorplan.  (These  func¬ 
tions  are  described  In  the  following  paragraphs.)  It  must  also  be  able 
to  input  cells  from  existing  libraries  and  also  be  able  to  Iterate  any 
given  cell.  To  save  on  main  memory  space,  each  one  of  the  above  men¬ 
tioned  functions  will  be  Implemented  as  a  separate  program  stored  on 
disk  and  called  Into  main  memory  only  If  and  when  It  Is  needed.  Not 
only  will  the  amount  of  main  memory  required  for  program  execution  be 
minimized,  but  also  the  execution  speed  thereby  enhancing  the  human- 


computer  interface.  Each  menu  must  be  totally  self  explanatory  with 
Instructions  and  detailed  error  messages  showing  the  user  exactly  what 
needs  to  be  entered.  The  responses  to  the  menus  will,  except  for 
numeric  responses,  be  single  letter  entries. 

2.3.1  Create  Function. 

HDCLL  must  be  able  to  create  a  new  CIF  file  based  on  the  users 
answers  to  menu  driven  design  questions.  Desired  functions  to  be  per¬ 
formed  are:  name  the  new  cell,  define  a  new  layer,  place  a  rectangle, 
lay  a  wire,  place  a  via,  place  a  round  flash,  place  a  polygon,  and 
Insert  a  port  for  connection  to  another  cell.  Any  of  these  Items  can  be 
given  a  name  (with  optional  point  location  and  layer)  for  easy  Identifi¬ 
cation  In  the  CIF  file  (and  on  the  CIF  plot  using  HCIFPLOT). 

2.3.2  Delete.  Place,  or  Hove  Function. 

The  HDCLL  system  must  allow  the  user  to  delete  a  cell  from  the 
hierarchy,  place  a  cell  In  a  given  location,  or  move  cells  from  one 
location  to  another  In  order  to  create  an  overall  Integrated  circuit. 
This  function  should  warn  the  user  If  any  cells  overlap  In  areas  other 
than  the  predefined  ports.  Also  available  In  this  routine  will  be  the 
ability  to  Iterate  cells. 

2.3.3  Hodifv  Function. 

HDCLL  must  allow  the  user  to  easily  modify  any  cell  In  the  circuit 
without  affecting  the  other  cells.  This  function  will  allow  the  user  to 
modify  not  only  the  primitive  elements  (lowest  level  cells  In  the  design 


hierarchy)  but  also  any  other  cell  In  the  hierarchy.  To  maintain  a 
structured  approach  to  designing  an  Integrated  circuit,  only  Intercon¬ 
nections  should  be  Included  with  calls  to  other  cells  In  any  cell  other 
than  a  primitive  element.  If  the  size  of  the  cell  changes  the  user  will 
be  notified  so  other  cells  In  the  circuit  may  be  adjusted  accordingly. 

2.3.4  Interconnect  Function. 

The  HDCLL  system  allows  the  user  to  Interconnect  cells  via  the 
cells  predefined  port  names.  Initially,  only  a  manual  mode  of  Intercon¬ 
nection  will  be  Implemented  by  use  of  the  CLL  wire  command  format  (15). 
If  an  Interconnection  Is  made  to  other  than  the  predefined  ports  a 
warning  message  will  be  Issued.  An  automatic  Interconnection  routine 
would  be  desirable,  but  will  not  be  Implemented  In  this  first  version  of 
HDCLL. 

2.3.5  Print/Plot  Function. 

The  HDCLL  system  should  provide  both  a  print  and  plot  routine.  The 
print  routine  should  allow  the  user  to  print  any  CIF  file  either  on  the 
screen  or  to  a  printer.  The  plot  routine  should  allow  the  user  to  plot 
any  circuit's  bounding  box  diagram  to  a  printer  or  plotter  or  the  entire 
CIF  layout,  using  HCIFPLOT  (7),  to  a  plotter. 

2.4  Performance. 


The  main  objective  associated  with  this  project  Is  to  provide  an 
easy  to  use  system  for  describing  the  physical  layout  of  VLSI  circuits. 
The  integrated  circuit  designer  must  be  able  to  use  HDCLL  without  becom- 


Ing  bored  waiting  for  the  computer  to  respond  or  frustrated  with  hard  to 
use  menus.  This  means  the  response  time  for  the  computer  should  be  no 
more  than  a  few  seconds  for  any  command  with  no  command  taking  longer 
than  expected  without  advising  the  user  of  the  processing  Involved  (I.e. 
the  user  knows  It  takes  longer  to  save  a  larger  file  to  disk  than  a 
smaller  file).  Descriptive  Inquiries  and  error  messages  must  be  provided 
to  ensure  the  user  does  not  become  confused  as  to  what  the  system  needs 
as  a  response.  Therefore,  the  menus  must  be  explicit  and  the  error 
messages  must  tell  the  user  exactly  what  Is  needed  as  Input. 

Another  primary  concern  Is  the  size  of  Integrated  circuit  the  HDCLL 
program  will  support.  Unfortunately,  this  can  only  be  described  In 
terms  of  memory  size  and  not  actual  number  of  transistors  on  chip  (or 
other  more  meaningful  terms).  The  usable  memory  will  be  limited  by  the 
largest  subprogram  In  the  HDCLL  system.  However,  since  this  is  a  cell- 
orlented  design  system,  this  Is  only  the  limit  of  one  cell  In  the 
circuit.  Any  number  of  cells  can  be  combined  to  form  a  circuit.  There 
Is  no  reason  why  a  designer  could  not  use  an  entire  diskette  for  one 
circuit  thereby  making  the  upper  limit  the  maximum  size  the  diskette  can 


store. 


3.1  Methodology. 

Since  the  Menu  Driven  Chip  Layout  Language  (HDCLL)  Is  an  extremely 
Interactive  system  the  main  concern  during  design  Is  the  ease  of  use  for 
the  VLSI  designer.  One  factor  Involved  In  the  ease  of  use  Is  the 
response  time  of  the  computer.  To  aid  In  handling  this  problem,  the 
system  Is  segmented  Into  eight  separate  programs  with  only  one  program 
being  resident  In  main  memory  at  any  time  and  the  other  programs  being 
called  In  as  needed.  This  allows  maximum  memory  space  for  use  as  a  work 
and  storage  area  for  the  programs  currently  running.  Only  after  one 
specific  cell  Is  completed  will  the  information  be  written  out  to  disk. 
By  doing  this,  the  system  advocates  (and  even  somewhat  forces)  the  use 
of  small  cells  (e.g.  a  subtractor  or  master  slave  flip  flop)  which  would 
then  be  linked  together,  with  the  necessary  Interconnects,  to  form 
larger  cells  and  eventually  entire  circuits.  This  segmentation  Into 
cells  serves  to  enhance  the  understandabll Ity  of  the  circuit  being 
designed.  This  is  sometimes  referred  to  as  a  highly  modularized  top- 
down  design,  bottom  up  Implementation  methodology  for  Integrated  circuit 
design.  It  Is  very  similar  to  the  Top  Down  Structured  Programming 
technique  used  by  software  engineers  to  produce  the  most  reliable  and 
maintainable  code  possible.  Integrated  circuit  designers  will  have  to 
eventually  adopt  some  form  of  top-down  structured  design  approach  due  to 
the  high  density  and  complexity  of  present  and  future  VLSI  circuits  In 


order  to  ensure  a  useful  end  product. 

The  following  paragraphs  describe  the  functional  composition  of  the 


main  program  and  each  subprogram  (also  referred  to  as  programs)  In  the 
MDCLL  system.  The  programs  In  the  system  are  MOCLL,  CREATE,  0PM 
(Delete,  Place,  or  Move),  MODIFY,  INTER,  PRIPLO,  FINALIZE,  and  SAVECELL. 
Only  the  basic  functions  of  each  program  are  described  here;  for 
complete  details  of  the  Implementation  of  each  program  see  Chapter  4. 

3.2  MDCLL  Program. 

The  MOCLL  executive  program  will  control  the  execution  of  the  other 
programs  in  the  MOCLL  system.  It  will  perform  several  major  functions. 
It  will  Initialize  the  system,  display  the  main  menu  for  the  user,  and 
be  responsible  for  bringing  Into  main  memory  the  requested  program.  The 
requested  program  will  then  be  executed  and  control  will  return  to  the 
main  menu  upon  completion.  From  the  user's  standpoint,  the  MDCLL  system 
can  be  considered  as  a  main  menu  calling  other  menus  In  the  MDCLL  system 
based  on  user  selected  options.  This  Is  functionally  shown  In  Figure 
3.1. 


I  I 

I  Main  Menu  I 


I  I 

I I 
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Create  | 

1 

1 

Delete 

Modify 
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I  Print/ 
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a  cell  1 

1 
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connect  j 
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Figure  3.1  MOCLL  User  Functions 
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I  Initialize  I  I  main  menu  I  I  fetch/run  I 
I  II  II  I 


I—  CREATE 
I—  DPM 
I—  MODIFY 
I—  INTER 
I—  PRIPLO 
I--  FINALIZE 

Figure  3.2  Executive  Level  Program 

The  Initialization  function  must  present  the  user  with  the  revision 
number  and  date  of  the  program  being  executed  along  with  some  basic 
Instructions  on  using  the  system. 

The  display  main  menu  routine  must  be  capable  of  not  only  display¬ 
ing  the  user's  options  In  an  easy  to  read,  easy  to  understand  format, 
but  also  prompt  for  a  response,  check  the  validity  of  the  response,  and, 
on  non-valld  entries,  produce  explicit  error  messages  to  the  user  to 
ensure  a  correct  entry.  The  options  to  le  displayed  allow  the  user  to 
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create  a  cell  (CREATE);  delete,  place,  or  move  a  cell  (DPH);  modify  a 
cell  (MODIFY);  interconnect  cells  (INTER);  print  files  or  plot  CIF 
layouts  (PRIPLO);  finalize  a  circuit  (FINALIZE);  or  allow  the  user  to 
exit  the  system.  Each  of  these,  except  for  exiting  the  system,  will  be 
a  separate  program  called  Into  memory  when  requested. 

The  fetch  and  run  function  must  be  capable  of  retrieving  the  cor¬ 
rect  program  from  disk  and  prompting  the  user  to  Insert  the  proper  disk 
If  the  program  requested  cannot  be  found  on  the  current  disk.  This 
function  must  also  be  capable  of  then  running  the  desired  program.  As 
shown  In  Figure  3.2  each  of  the  subprograms  can  be  considered  as  subor¬ 
dinate  to  this  function. 


3.3  CREATE  Subprogram. 

The  CREATE  subprogram  of  HOCLL  must  allow  the  user  to  create  a  new 
CIF  file  based  on  responses  to  menu  driven  questions.  The  cells,  thus 
created,  are  considered  to  be  the  basic  elements  of  the  circuit  being 
designed  since  all  circuits  are  composed  of  these  cells  (termed  primi¬ 
tive  cells)  grouped  together  with  the  appropriate  Interconnections.  The 
CREATE  subprogram  is  the  most  important  since  It  will  produce  the  primi¬ 
tive  cells  for  use  in  later  phases  of  the  design  process.  The  file 
created  will  be  a  totally  CIF  compatible  file  and  can  be  used  with  other 
design  tools  (e.g.  design  rule  checkers  and  MCIFPLOT).  A  separate  file 
on  disk  will  be  created  for  each  new  primitive  cell  created  and  will  be 
designated  with  a  ".cif"  extension.  As  Figure  3.3  shows,  the  main 
functions  of  CREATE  are  naming  the  cell,  displaying  the  menu,  and  imple¬ 
menting  the  desired  option. 
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I  I 

I  CREATE  I 

I _ I 


I 


I  II  II  I 

I  name  cell  I  I  display  menu  |  I  Implement  I 


--  port 
--  rectangle 
--  wire 

—  via 

--  round  flash 

—  SAVECELL 


Figure  3.3  CREATE  subprogram 


The  options  performed  In  creating  a  primitive  cell  consist  of 
placing  an  Interconnection  port,  rectangle,  wire,  via,  or  round  flash. 
Other  options  available  will  be  to  exit  to  the  main  menu  after  saving 
the  cell  or  quit  without  saving  the  cell.  Figure  3.3  shows  the  function 
of  Implementing  an  option  will  not  only  Incorporate  sub-functions  to 
handle  these  capabilities,  but  also  Includes  the  execution  of  the 
SAVECELL  subprogram. 

3.4  OPH  Subprogram. 

The  functions  to  delete,  place,  or  move  an  existing  cell  (DPH 
subprogram)  are  grouped  together  since  their  functions  are  similar. 

These  functions  will  make  extensive  use  of  the  same  subroutines.  Figure 
3.4  shows  the  functional  chart  for  this  subprogram.  The  three  main 
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I  I 

I  0PM  I 
I _ 1 


I 
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I  II  II  I 

I  display  I  I  Get  the  cell  I  I  Implement  I 

I  menu  I  I  parameters  I  I  j 


"  place 
--  Iterate 
--  modify 

—  delete 

—  SAVECELL 


Figure  3.4  OPH  subprogram 

functions  of  OPH  are  to  display  the  menu  of  possible  options,  fetch  the 
cell  parameters,  and  implement  the  desired  function. 

The  delete  function  must  allow  the  user  to  delete  a  cell  from  the 
design.  This  Includes  not  only  the  primitive  cells  but  cells  anywhere 
In  the  hierarchy  of  the  design  along  with  Iterated  cells.  The  place 
function  must  allow  for  the  creation  of  new  levels  of  the  hierarchy  and 
place  lower  levels  Into  the  new  level.  These  higher  levels  of  the 
design  (any  level  above  the  primitive  cells)  will  also  be  written  to 
disk  and  will  also  be  totally  CIF  compatible  and  therefore  designated 
with  a  ".elf"  extension.  (To  obtain  CIF  files  from  these  cells,  usable 
In  HCIFPLOT,  the  user  must  first  enact  the  FINALIZE  program  under  the 
main  menu.  This  program  Is  described  In  paragraph  3.8  below.)  The 
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place  function  must  also  have  the  capability  of  placing  primitive  cells 
from  an  existing  library  of  cells.  It  must  also  have  the  capability  to 
Iterate  cells  as  In  the  CLL  language.  The  modify  function  must  allow 
the  user  to  move  cells  within  the  parent  cell  layout,  it  should  also 
give  warning  messages  it  cne  movement  causes  any  cells  to  overlap  and 
allow  the  user  to  change  the  Interconnections  between  these  cells  as 
needed.  As  Figure  3.3  shows,  the  function  of  Implementing  an  option 
will  not  only  Incorporate  sub-functions  to  handle  these  capabilities, 
but  also  Includes  the  execution  of  the  SAVECELL  subprogram. 


3.5  MODIFY  Subprogram. 

The  MODIFY  subprogram  will  allow  the  user  to  modify  not  only  any 
primitive  cell  In  the  system  but  also  any  cell  In  the  hierarchy  of  cells 
making  up  a  circuit.  As  shown  In  Figure  3.5  the  major  functions  needed 
to  perform  a  modification  are  to  retrieve  the  requested  file,  determine 
the  type  of  modification  (I.e.  add.  delete,  or  change  parameters), 
display  a  menu  of  options  available  for  modifying  a  cell,  and  then 


Implement  the  desired  option.  If  the  type  of  modification  to  be  per¬ 


formed  Is  to  add  parameters  to  the  cell,  then  the  menu  used  for  creating 
a  cell  along  with  the  Implement  function  for  creating  a  cell  are  used 
(Paragraph  3.3).  This  Is  to  reduce  the  complexity  and  number  of  modules 
In  the  MDCLL  system. 

The  options  which  can  be  performed  In  modifying  a  cell,  other  than 
adding  to  the  cell,  consist  of  modifying  or  deleting  an  Interconnection 
port,  rectangle,  wire,  via,  or  round  flash.  Other  options  available 
will  be  to  exit  to  the  main  program  after  saving  the  cell  or  quit 


without  saving  the  cell.  As  Figure  3.5  shows,  the  function  of  Implemen¬ 
ting  an  option  will  not  only  Incorporate  sub-functions  to  handle  these 
capabilities,  but  also  Include  the  execution  of  the  SAVECELL  subprogram. 
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Figure  3.5  MODIFY  subprogram 


k>.>o 


I 


I 

INTER  I 


I 

I 

_ I _ 

I  I 

I  get  the  | 

I  cell  I 


I  I 

I  connect  the  I 
I  cell  I 


I 


I 

I 

_ I _ 

I  I 

I  SAVECELL  I 

I  I 

I _ I 


Figure  3.6  INTER  subprogram 


3.7  PRIPLO  Subprogram. 

The  PRIPLO  subprogram  contains  two  highly  related  functions.  The 
print  function  of  this  program  should  allow  the  user  to  print  any  ".elf 
file  on  either  the  screen  or  printer.  The  plot  function  should  allow 
the  user  to  plot  the  CIF  layout  of  the  cell  using  HCIFPLOT  on  a  plotter 
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Figure  3.7  PRIPLO  subprogram 


or  Just  the  bounding  box  diagram  on  a  printer  or  plotter.  This  will 
allow  the  user  to  visualize  the  entire  circuit  a  section  at  a  time.  As 
shown  In  Figure  3.7  the  main  functions  of  this  subprogram  are  to  get  the 
cell  and  perform  the  print  or  the  plot. 

3.8  FINALIZE  Subprogram. 

The  FINALIZE  subprogram  should  only  be  used  when  a  circuit  Is 
finished  and  a  complete  GIF  file  Is  needed  or  when  the  user  needs  to  use 
HCIFPLOT  to  obtain  a  plot  of  a  cell  which  calls  subordinate  cells.  The 
finalization  routine  will  start  at  the  highest  level  of  the  hierarchy 
for  the  circuit  and  create  a  ".elf  file  based  on  the  calls  to  other 
lower  level  cells  and  any  Interconnection  wires  contained  therein.  The 
main  functions  of  this  program  are  to  retrieve  the  cells  and  then  for¬ 
mat  the  GIF  file  while  processing  the  call  statements.  See  Figure  3.8 
for  the  functional  chart  showing  this. 
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Figure  3.8  FINALIZE  subprogram 


3.9  SAVECELL  Subprogram. 

The  SAVECELL  subprogram  Is  executed  by  the  other  subprograms  In  the 
HOCLL  system  to  save  a  cell  to  disk.  SAVECELL  performs  only  one  basic 
function  which  Is  to  save  the  Information  stored  In  memory  out  to  disk. 
However,  this  basic  function  can  be  broken  down,  as  shown  In  Figure  3.9, 
Into  outputting  the  CIF  file  header,  the  CIF  cell  layout,  and  the  CIF 
file  footer. 
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Figure  3.9  SAVECELL  subprogram 


4.  Detailed  Design 

The  programs  of  the  HDCLL  system  are  designed  using  small,  indepen¬ 
dent  modules.  Each  program  (actually  subprograms,  but  since  each  one 
can  stand  alone  they  are  all  referred  to  as  programs)  in  the  system  not 
only  has  its  own  modules  available  to  It  but  also  the  modules  of  any  of 
the  other  programs  through  the  use  of  libraries  included  in  each  program 
as  needed.  This  helps  to  reduce  the  amount  of  code  needed.  Also,  since 
there  are  no  duplicate  modules  to  contend  with,  the  use  of  standard 
libraries  aids  in  future  maintainability. 

The  detailed  design  started  with  the  upper  level  hierarchy  charts 
shown  in  Chapter  3.  These  were  then  further  broken  down,  one  program 
and  one  module  at  a  time.  The  final  hierarchy  charts  for  the  system  are 
shown  in  Appendix  A  along  with  the  structure  charts.  The  hierarchy 
charts  are  also  included  in  the  header  to  each  program  in  the  system 
(see  Appendix  B).  Hopefully,  this  will  encourage  future  maintainers  to 
not  only  update  the  code  but  also  the  hierarchy  charts.  An  English-like 
Program  Design  Language  (PDL)  was  then  used  to  give  each  module  the 
final  detailed  design  which  could  then  be  coded.  This  PDL  Is  Included 
In  the  header  to  each  module,  as  shown  in  Appendix  B,  to  once  again 
allow  the  programs  to  be  maintained  more  easily. 

The  following  paragraphs  describe  in  detail  the  design  of  the 
entire  HDCLL  system.  First,  the  header  used  throughout  the  system  Is 
described.  The  main  program  (HDCLL)  is  then  described  followed  by  each 
of  the  subprograms  which  it  is  capable  of  calling  (CREATE,  DPH,  HODIFY, 
INTER,  PRIPLO,  and  FINALIZE).  The  SAVECELL  subprogram  is  described  last 
since  It  Is  called  by  the  CREATE,  DPH,  and  HODIFY  subprograms. 


4. 1  Header. 


The  header  was  designed  to  be  standard  for  each  program  In  the 
HOCLL  system.  This  standard  header  is  used  at  the  beginning  of  each 
program  in  the  system  even  though  not  every  program  uses  every  part  of 
the  header.  This  is. once  again  for  ease  of  maintenance.  There  are  four 
separate  sections  to  the  header;  the  include  files  needed,  the  global 
constants  defined,  the  global  variables,  and  the  structures  for  storing 
the  HDCLL  Intermediate  Form  representation  (HIF;  not  quite  the  Caltech 
Intermediate  Form  but  almost). 

4.1.1  Include  Statements. 

First  In  the  header  are  two  include  statements.  These  provide  the 
necessary  code  for  the  function  of  printing  to  the  terminal  (the 
"printf"  command)  and  the  function  of  executing  one  program  from  another 
(the  “exec"  command:  a  microcomputer  version  of  the  “system"  command 
described  in  Kernighan  and  Ritchie).  Each  of  these  commands  is  used  in 
each  of  the  programs  in  the  HOCLL  system. 

4.1.2  Global  Constants. 

Next  in  the  header  are  the  global  constants.  These  are  provided  up 
front  so  when  design  rule  changes  are  needed  the  constants  associated 
with  these  rules  will  be  easily  accessible.  These  constants  are  for 
lambda  to  CIF  scaling  factors  and  via  sizes.  Also  included  here  are  the 
standard  declarations  needed  by  most  programs:  end  of  file,  true,  false, 
and  null.  The  last  constant  defined  is  the  amount  of  available  memory 
space  for  the  stored  HIF.  This  Is  used  in  determining  the  memory  space 


left  In  the  system  in  comparison  with  the  amount  used  when  adding  to  the 

layout  of  cells.  This  Is  provided  so  the  user  doesn't  try  to  exceed  the 

memory  capabilities  of  the  machine,  although  In  this  version  the  user  Is 
not  prevented  from  doing  so.  It  is  Initially  set  at  20K  which  Is 
derived  In  the  following  manner.  Start  with  a  64K  system;  subtract  the 
16K  needed  for  the  CPH  operating  system;  subtract  the  size  of  the  larg¬ 
est  program  In  the  HDCLL  system  to  ensure  all  programs  can  be  run  on  any 

cell  (26K  for  the  MODIFY  program).  This  leaves  22K  usable  memory. 
Leaving  2K  as  a  buffer  gives  20K  or  20480  bytes  of  usable  memory. 

4.1.3  Global  Variables. 

Mhen  this  project  was  started,  no  global  variables  (except  the 
structures  described  next)  were  envisioned.  As  time  became  a  factor  and 
things  were  getting  frantic  (situation  norma)  for  software  development) 
global  variables  suddenly  appeared.  These  variables  should  be  placed 
back  Into  the  modules  as  passed  parameters  as  time  permits. 

4.1.4  Structures  used  for  Storage. 

Finally  the  most  important  part  of  the  header:  the  structures  for 
storing  the  MDCLL  Intermediate  Form  (HIF)  which  will  be  translated  to 
the  Caltech  Intermediate  Form  (CIF)  upon  output  to  disk.  The  seven 
separately  defined  structures  are  lnter_ports,  rectangle,  via,  wire, 
cal 1_statement,  1ter_statement,  and  cal1ed_ce11s. 


4. 1.4.1  Inter  ports  Structure. 

The  Inter  ports  structure  Is  used  for  holding  the  Information 


describing  an  Interconnection  port.  This  Is  the  portname,  the  layer  In 
Mhich  the  port  resides,  and  the  x.y  location  of  the  port.  Also  Included 
In  this  structure  Is  a  pointer  to  the  next  port  to  form  a  linked  list  of 
Interconnection  ports. 

4. 1.4. 2  rectangle  Structure. 

The  rectangle  structure  Is  used  not  only  for  holding  rectangle 
Information  described  by  the  user,  but  also  for  holding  the  necessary 
Information  to  describe  user  defined  wire  statements.  This  second 
purpose  Is  only  used  when  the  wire  Is  being  saved  to  disk  as  a  series  of 
rectangles  by  the  SAVECELL  program.  The  Information  needed  to  describe 
a  rectangle  (or  box)  In  CIF  Is  the  height,  length,  and  x.y  location. 

Also  Included  In  this  structure  are  three  pointers  to  the  next  defined 
rectangles.  These  pointers  form  a  trinary  tree  of  rectangle  definitions 
based  on  the  value  of  the  x  location.  There  are  eight  variables  used  as 
pointers  to  the  rectangle  structure.  Four  of  these  point  to  the  Initial 
rectangles  defined  by  the  user,  one  for  each  layer  available.  The  other 
four  point  to  the  rectangles,  by  layer,  needed  for  the  conversion  of 
wires'to  CIF.  This  form  of  storage  was  chosen  to  allow  the  user  to 
define  and  modify  the  rectangles  by  layer.  It  was  also  chosen  so  only 
one  CIF  layer  statement  would  be  generated  for  all  the  rectangles  In  a 
cell  for  a  given  layer  and  only  one  CIF  layer  statement  for  all  the 
rectangles  generated  by  wire  statements  In  a  given  layer.  This  reduces 
the  amount  of  CIF  produced  compared  with  the  Chip  Layout  Language  (CLL). 
which  produces  a  new  CIF  layer  statement  each  time  It  encounters  a 
different  layer  Instead  of  gathering  rectangles  by  layer  as  HDCLL  does. 


4. 1.4. 3  vj_a  Structure. 

The  via  structure  is  similar  to  the  rectangle  structure  in  that  it 
is  used  for  not  only  holding  user  defined  via  information  but  also  for 
storing  the  necessary  via  Information  for  user  defined  wire  statements 
that  change  layers.  These  wire  defined  vias  are  only  used  by  the 
SAVECELL  program.  The  only  Information  needed  for  a  via  Is  the  x.y 
location  and  the  layer  as  given  by  the  pointer.  As  in  the  rectangle 
structure,  the  via  structure  has  three  pointers  defined.  These  pointers 
form  a  trinary  tree  of  via  definitions  based  on  the  value  of  the  x 
location.  This  form  of  storage  was  chosen  to  allow  the  user  to  define 
and  modify  the  vias  by  layer.  It  was  also  chosen  so  only  one  CIF  layer 
statement  would  be  generated  for  each  of  the  parts  of  the  vias  in  a 
given  layer  and  similarly  only  one  CIF  layer  statement  for  each  part  of 
the  vias  generated  by  wire  statements  in  a  given  layer.  This  reduces 
the  amount  of  CIF  produced  compared  with  the  Chip  Layout  Language  (CLL), 
which  produces  a  new  CIF  layer  statement  each  time  It  encounters  a 
different  layer  instead  of  gathering  vias  by  layer  as  MDCLL  does. 

4. 1.4. 4  wire  Structure. 

The  wire  structure  is  different  from  the  previously  defined  struc¬ 
tures.  This  is  caused  by  the  fact  that  a  wire  has  an  unspecified  number 
of  segments.  For  this  reason  the  wire  structure  contains  only  the 
starting  x.y  location,  a  pointer  to  the  first  set  of  wire  pa< ameters 
{first  wire  segment),  and  the  three  pointers  forming  a  trinary  tree  to 
other  wires  based  on  the  value  of  the  x  location.  There  is  only  one 
trinary  wire  tree  structure  defining  the  starts  for  wire  statements. 


This  single  structure  Is  used  to  allow  the  user  to  modify  wire  segments, 
at  will.  Including  not  only  the  width  and  length,  but  also  the  segments' 
layers.  The  only  reference  is  by  x  location.  The  wire  Is  converted  to 
rectangles  just  before  saving  the  cell  to  disk  which  allows  for  savings 
In  layer  statements  as  described  above  for  the  rectangle  structure.  The 
Internal  structure  w1 re_parameters  contains  the  necessary  Information 
for  each  segment  of  the  wire.  This  Is  the  width,  length,  layer,  and 
direction  of  the  wire  segment.  Also  Included  Is  a  pointer  to  the  next 
wire  segment. 

4. 1.4.5  call  statement  Structure. 

The  cal l_statement  structure  holds  all  Information  needed  to  create 
a  CIF  call  statement.  This  Includes  the  name  of  the  cell  to  be  called, 
the  associated  CIF  number,  the  location  to  where  the  cell  Is  to  be 
translated,  If  the  cell  Is  to  be  flipped  upside  down  (mirrored  In  y  In 
CIF  language).  If  the  cell  Is  to  be  flipped  left  to  right  (mirrored  In 
x),  the  rotational  position  of  the  x  axis  (limited  as  In  CLL  to  the  3, 

6,  9,  and  12  o'clock  positions),  and  the  bounds  of  the  cell  being 
called.  As  In  the  wire  structure,  the  cal l_statement  structure  has  an 
internal  structure  associated  with  it.  This  is  the  named_ports  struc¬ 
ture  which  defines  the  names  for  Interconnection  ports  for  the  called 
cell  which  should  match  In  number  to  the  Interconnection  ports  defined 
In  the  called  cell.  Included  In  the  named_ports  structure  Is  the  port's 
name  and  a  pointer  to  the  next  port.  The  cal 1_statements  are  kept  In  a 
trinary  tree  based  on  the  value  of  the  CIF  number. 


4. 1.4.6  Iter  statement  Structure. 

The  1ter_statement  structure  contains  the  necessary  information  to 
iterate  a  cell.  The  information  stored  is  the  name  of  the  cell  to  be 
iterated,  the  CIF  number  of  the  cell,  the  number  of  iterations  in  the  x 
and  y  directions,  the  x  and  y  pitch  or  spacing  of  the  cells,  and  a 
pointer  to  the  cal 1_statement  structure  for  holding  the  translation,  the 
flipping  instructions,  the  direction  of  the  rotation,  the  bounds  of  the 
cell,  and  any  associated  port  names.  As  with  the  call  statements  the 
Iterate  statements  are  stored  as  a  trinary  tree  based  on  the  value  of 
the  CIF  number. 

4. 1.4. 7  called  cells  Structure. 

The  caned_cens  structure  is  used  by  the  FINALIZE  program  to 
ensure  all  the  called  cells  are  included  once,  and  only  once,  in  the 
final  CIF  file.  It  is  a  linked  list  containing  the  cellnames  and  CIF 
numbers  of  the  called  cells. 

4.2  MDCLL  Main  (Module  0.0). 

The  MOCLL  program  is  broken  down  into  three  basic  functions,  as 
shown  in  Figure  4.1  and  the  hierarchy  chart  in  Appendix  A.  A  single 
character  Is  accepted  as  an  input  parameter.  Based  on  this  character 
the  Initialization  routine  (Module  0.1)  may  or  may  not  be  executed. 

Then  the  options  are  displayed  for  the  user  (Main_Menu  Module  0.2)  and 
the  proper  program  is  finally  executed  (Fetch_Run  Module  0.3). 
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Figure  4.1  Hodules  for  HDCLL  Main 


4.2.1  Initialization  (Hodule  0.1). 

The  Initialization  function  provides  a  brief  message  describing  the 

program  Including  the  version  being  executed.  It  also  provides  the  user 
with  Instructions  not  only  on  using  the  system,  but  also  on  how  to  not 
get  the  Instructions  In  the  future  If  not  wanted. 

4.2.2  Hain  Menu  (Hodule  0.2). 

The  main  menu  function  simply  provides  the  user  with  the  option  of 
running  one  of  the  HDCLL  programs  or  exiting  to  the  operating  system. 

If  the  selected  character  Is  not  a  valid  option  an  error  message  stating 
so  Is  printed  along  with  the  menu.  The  user  Is  then  asked  to  choose 
again.  Once  a  valid  option  Is  obtained,  this  option  Is  then  passed  back 
to  the  main  module. 

4.2.3  Fetch  Run  (Hodule  0.3). 


The  fetch  and  execute  function  accepts  the  option  of  which  program 
Is  to  be  executed  as  Input.  This  module  then  makes  sure  the  requested 
program  Is  on  disk  and  then  executes  It.  Due  to  this,  the  six  programs 


CREATE.  OPM,  HOOIFY,  INTER.  PRIPLO.  and  FINALIZE  should  be  considered 
subprograms  to  HOCLL  although  In  this  text  they  are  referred  to  as 
programs . 


4.3  CREATE  Main  (Module  1.01. 

The  CREATE  program  Is  used  to  create  a  new  cell  based  on  user 
Inputs  to  menu  driven  questions.  It  has  three  basic  functions.  It 
first  gets  the  cellname  from  the  user  (Module  1.1  Name_Ce11)  and  deter¬ 
mines  if  the  name  Is  already  In  use.  If  the  name  Is  already  In  use  (on 
the  current  disk)  then  the  name  Is  not  allowed  and  the  user  must  enter 
another.  Once  a  valid  name  Is  entered  CREATE  prints  the  menu  of  options 
(Module  1.2  C_Menu)  available  and  Implements  the  desired  option  (Module 

1.3  Implement)  unless  the  quit  option  was  selected  In  which  case  the 
HOCLL  system  Is  exited.  The  modules  of  the  CREATE  program  library  are 
shown  In  Figure  4.2  and  described  In  the  following  paragraphs. 

4.3.1  Name  Cell  (Module  1.11. 

Name_Cell  Is  used  throughout  the  HOCLL  system  to  obtain  the  name  of 
a  cell  from  the  user  and  to  translate  this  name  to  the  appropriate 
filename  (I.e.  add  the  ".CIF"  extension  to  the  cellname).  This  module 
also  strips  off  any  disk  drive  letter  from  the  cellname  while  leaving 
this  prefix  on  the  filename.  This  module  then  checks  the  disk  drive  to 
see  If  the  named  file  Is  already  on  disk  or  not.  This  on_d1sk  flag, 
along  with  the  filename  and  cellname.  are  then  passed  back  to  the 
calling  program. 
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Figure  4.2  CREATE  Program  Library  Modules 


4.3.2  C  Menu  (Module  1.2] 


The  C_Henu  module  displays  the  available  options  to  the  user  and 
then  requests  the  user  to  pick  one  of  the  options  (Get_0pt1on  Module 


1.2.1)  based  on  a  one  character  entry.  It  accepts  the  cellname  as  Its 
only  Input,  simply  to  display  with  the  menu  so  as  to  appear  more  friendly 
to  the  user.  If  the  selected  character  Is  not  a  valid  option,  an  error 
message  stating  so  Is  printed  along  with  the  menu  and  the  user  Is  asked 
to  choose  again.  Once  a  valid  option  Is  obtained.  It  Is  passed  back  to 
the  cal  ling  module. 


4.3.2. 1  Get  Potion  (Module  1.2.11. 

The  Get_0pt1on  module  Is  used  throughout  the  HDCLL  system  to  obtain 
a  one  character  entry  from  the  user.  After  getting  the  single  character 
from  the  user  It  Is  converted  to  upper  case.  If  the  entered  character 
was  not  a  return  then  the  module  continues  getting  characters  until  a 
return  Is  encountered.  This  Is  to  ensure  no  stray  characters  are  left 
In  the  machines  buffer  for  the  next  time  an  Input  from  the  user  Is 
needed. 


4.3.3  Implement  (Module  1.31. 

The  Implement  module  simply  acts  as  a  clearing  house  where  the 
option,  filename,  and  cellname  are  passed  Into  the  module,  and  the 
appropriate  function  Is  then  performed.  The  functions  available  are  to 
define  an  Interconnection  port  (Oef_Port  Module  1.3.1),  define  a  rectan¬ 
gle  (Def_Rectangle  Module  1.3.2),  define  a  wire  (Def_W1re  Module  1.3.3), 
define  a  via  (Def_V1a  Module  1.3.4).  define  a  round  flash  (Def_Flash 
Module  1.3.5),  print  all  the  work  accomplished  on  the  present  cell  as 
stored  In  the  structures  (Pr1nt_Mork  Module  1.3.6),  and  save  the  cell  to 
disk  (Save_Cel1  Module  1.3.7). 
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4.3.3. 1  Def  Port  (Module  1.3.11. 

The  Def_Port  module  allows  the  user  to  define  the  parameters  that 
make  up  an  Interconnection  port.  These  are  the  portname,  the  layer  the 
port  Is  on  (Def_Layer  Module  1.3. 1.1).  and  the  x.y  location  (Get_Num 
Module  1.3. 1.2)  of  the  port.  The  defined  port  Is  then  stored  In  the 
linked  list  of  1nter_port  structures  (Port_Tree  Module  1.3. 1.3).  The 
user  Is  then  asked  If  there  are  more  ports  to  be  place  and  If  the  answer 
(Get_0pt1on  Module  1.2.1)  Is  no  this  module  Is  exited.  This  function  Is 
not  presently  used  In  the  MOCLL  system  but  Is  envisioned  to  allow  easy 
Interconnection  of  cells  based  on  port  names  and  eventually  automatic 
routing. 

4.3.3. 1.1  Def  Laver  (Module  1.3.1.11. 

The  Def_Layer  module  allows  the  user  to  define  the  desired  layer. 

If  the  current  layer  Is  valid  for  the  next  function  to  be  performed, 
based  on  the  input  parameter  1ayer_va11d,  then  this  module  asks  If  the 
default  layer  (the  current  layer)  Is  wanted.  If  the  default  layer  Is 
wanted  the  module  exits  without  making  any  changes,  otherwise  It  sets 
the  layer  to  non-valld  and.  while  the  layer  Isn't  valid,  the  optional 
layers  are  printed  and  an  option  Is  obtained  (Get_0pt1on  Module  1.2.1). 
Finally  the  global  variable  "layer"  Is  set  to  the  valid  layer  selected. 

4. 3. 3. 1.2  Get  Hum  (Module  1.3.1.21. 

The  module  Get_Num  obtains  a  string  from  the  user  or  a  file  one 
ASCII  character  at  a  time,  based  on  the  Input  parameter  "fp".  This 
process  continues  until  either  a  space,  comma,  semicolon,  return,  or  a 


35 


close  parenthesis  Is  encountered.  This  ensures  compatibility  when  get¬ 
ting  numbers  from  a  CIF  file  on  disk.  This  string  Is  then  converted  from 
ASCII  to  Integer  using  the  C  command  ‘‘atoi".  If  the  Input  Is  coming 
from  the  terminal,  and  the  last  entered  character  was  not  a  return,  then 
the  module  continues  getting  characters  until  a  return  Is  encountered. 
This  Is  to  ensure  no  stray  characters  are  left  In  the  machine's  buffer 
for  the  next  time  an  Input  from  the  user  Is  needed.  The  Integer  Is  then 
passed  back  to  the  calling  program. 

4. 3. 3. 1.3  Port  Tree  (Module  1.3.1.31. 

The  Port_Tree  module  places  a  portname  and  parameters  Into  the  next 
available  port  location.  It  accepts  the  portname,  x  and  y  location,  and 
a  pointer  to  the  next  port  location  as  Input  parameters.  It  first 
determines  If  the  pointer  Is  pointing  to  an  existing  port  structure.  If 
It  Is,  then  the  program  is  called  recursively  with  the  next  port  pointer 
being  passed  as  the  current  port  pointer.  After  finding  a  location  that 
Isn't  defined  the  appropriate  amount  of  memory  Is  allocated  and  the 
portname  and  x,y  location  Is  stored  In  the  1nter_ports  structure. 

4. 3. 3. 2  Def  Rectangle  (Hodule  1.3.21. 

The  Oef_Rectangle  module  first  requests  the  user  to  define  which 
layer  Is  to  be  used  (Def_Layer  Module  1.3. 1.1)  It  then  obtains,  based 
on  user  responses  to  questions,  the  rectangle  parameters  height,  length, 
and  x,y  location  of  the  bottom  left  corner  of  the  rectangle  (Get_Mum 
Module  1.3. 1.2).  The  rectangle  parameters  are  then  stored  In  the  rec¬ 
tangle  structure  {Rect_Tree  Module  1.3. 2.1)  based  on  the  layer  In  which 
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the  rectangle  Is  placed  with  an  entirely  separate  structure  for  each 
layer  defined.  The  user  may  then  place  another  rectangle  In  the  present 
layer  based  on  a  yes,  no  response  (6et_0pt1on  Module  1.2.1).  If  no  more 
rectangles  are  to  be  defined  In  the  present  layer  then  the  user  may 
define  rectangles  In  another  layer. 

4. 3. 3. 2.1  Rect  Tree  (Module  1.3.2.11. 

The  Rect_Tree  module  accepts  a  rectangles  height,  length,  x  and  y 
location,  and  a  pointer  to  the  next  rectangle  location.  If  this  loca¬ 
tion  is  defined  (i.e.  has  a  rectangle  already  placed)  then  If  the  x 
value  to  be  placed  Is  less  than  the  x  value  In  the  present  location  this 
module  Is  recalled  with  the  pointer  to  the  left  tree  location  as  the 
Input  pointer;  If  the  x  value  to  be  placed  Is  equal  to  the  present  x 
value  then  the  middle  tree  pointer  Is  used  as  the  Input  pointer;  and  If 
the  X  value  to  be  placed  Is  greater  than  the  present  x  value  the  right 
tree  pointer  Is  used  as  the  next  Input  pointer  location.  Once  a  non- 
deflned  location  Is  found  the  module  allocates  space  and  then  loads  the 
rectangle  Information  Into  the  rectangle  structure. 


4. 3. 3. 3  Def  Wire  (Module  1.3.31. 

The  0ef_W1re  module  allows  the  user  to  place  wire  statements  which 
can  not  only  change  directions  and  widths  but  also  layers  anywhere  In 
the  statement.  First  a  starting  x.y  location  has  to  be  defined  (Get_Num 
Module  1.3. 1.2).  This  Is  all  the  Information  needed  to  start  the  wire 
structure  (S_M1re_Tree  Module  1.3. 3.1).  Next  the  user  can  Input  as  many 
segments  as  wanted  (Get_H  Option  Module  1.3.3.2).  The  layer  (Def  Layer 


Module  1.3. 1.1)  and  width  can  be  changed  and  only  after  a  direction  and 
length  for  the  wire  segment  Is  defined  Is  the  segment  saved  to  memory 
(P1ace_H1re_Parameters  Module  1.3. 3. 3).  After  finishing  one  wire  the 
user  may  enter  another  wire  or  exit  this  module  (Get_0pt1on  Module 
1.2.1). 

4. 3. 3. 3.1  S  Wire  Tree  (Module  1. 3.3.1). 

The  module  S_W1re_Tree  Is  used  to  Initialize  a  wire  statement  In 
memory.  The  x.y  location  along  with  a  pointer  to  a  wire  location  Is 
Input  to  this  module.  If  the  location  is  already  defined  with  a  wire 
start  then  the  x  value  of  the  wire  start  to  be  placed  Is  compared  with 
the  X  value  of  the  already  stored  wire.  The  appropriate  leg  of  the 
trinary  tree  Is  then  used  In  the  next  recursive  call  to  this  module. 

Once  an  empty  location  Is  found,  memory  space  Is  allocated,  the  x.y 
location  Is  stored  In  the  structure,  and  the  pointer  to  the  start  of 
this  wire's  segments  Is  Initial  1 1zed. 

4. 3. 3. 3. 2  Get  H  Potion  (Module  1,3. 3.2). 

The  Get_W_0pt1on  module  accepts  the  present  default  width  and  layer 
as  Input  to  print  the  available  options  to  the  user.  The  user  Is  then 
asked  to  make  a  selection  and,  once  a  valid  option  Is  chosen,  this 
option  Is  returned  to  the  calling  program. 


4. 3. 3. 3. 3  Place  Wire  Parameters  (Module  1.3. 3. 3). 


location  being  examined  already  contains  a  segment,  then  the  module  Is 
recursively  called  with  the  next  segment  pointer  as  Input.  Once  an 
empty  location  Is  found  this  module  allocates  memory  and  then  stores  the 
wire  segment  parameters  In  the  w1 re_parameters  structure. 
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4. 3. 3. 4  Def  Via  (Module  1.3.41. 

The  Def_V1a  module  allows  the  user  to  define  a  via  In  the  cell.  It 
first  determines  a  layer  for  the  vlas  to  be  defined  (Def_Layer  Module 
1.3. 1.1)  and  then  accepts  via  x  and  y  locations  (Get_Num  1.3. 1.2).  It 
then  places  this  Information  In  the  proper  layer  via  structure  In  memory 
based  on  the  value  of  the  x  location  (V1a_Tree  Module  1.3. 4.1).  The 
user  can  continue  placing  vlas  In  the  current  default  layer  or  switch  to 
a  different  layer  to  define  vlas  before  exiting  to  the  calling  module 
(Get_0pt1on  Module  1.2.1). 


4. 3. 3. 4.1  Via  Tree  (Module  1.3.4.11. 

V1a_Tree  accepts  the  via  x  and  y  location  along  with  a  pointer  to  a 
location.  If  the  location  already  contains  a  via  then  the  V1a_Tree 
module  Is  called  recursively  with  the  new  location  being  based  on  com¬ 
parison  of  the  X  value  to  be  placed  with  the  present  x  value.  Once  an 
empty  location  Is  found,  memory  space  Is  allocated  and  the  via  x  and  y 
location  Is  placed  In  the  via  structure. 

4. 3. 3. 5  Def  Flash  (Module  1.3.51. 

The  Oef_Flash  module  Is  not  yet  Implemented.  It  should  be  very 
similar  to  the  Def_Rectang1e  module  except  the  Inputs  from  the  user 
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would  be  those  necessary  for  defining  a  round  flash  In  CIF.  In  partic¬ 
ular,  It  would  have  to  accept  the  x  and  y  location  and  the  diameter  of 
the  flash  and  then  need  a  sub-module  to  place  the  flash  parameters  In 
memory  similar  to  the  Rect_Tree  module.  The  structure  being  filled  by 
the  round  flash  Information  would  also  need  to  be  defined  In  the  header 


4. 3. 3. 6  Print  Work  (Hodule  1.3.61. 

The  Pr1nt_Mork  module  allows  the  user  to  see  the  work  accomplished 
on  the  particular  cell  being  worked  on.  It  steps  the  user  through  each 
available  structure  determining  If  that  structure  Is  needed  to  be  dis¬ 
played  (Get_0pt1on  Hodule  1.2.1).  The  Items  which  can  be  displayed  are 
the  predefined  ports  (Walk_P_Tree  Hodule  1.3. 6.1),  the  rectangles  by 
layer  In  which  they  are  defined  (Malk_R_Tree  Hodule  1.3. 6. 2),  the  wires 
(Malk_W_Tree  Hodule  1.3. 6, 3),  the  vlas  one  layer  at  a  time  (Hah _V_Tree 
Hodule  1.3. 6. 4),  the  call  statements  (MallC_C_Tree  Hodule  1.3. 6. 5),  and 
the  iterate  statements  (Malk_I_Tree  Hodule  1.3. 6. 6).  The  last  two, 
calls  and  Iterates,  are  only  Included  here  for  completeness  even  though 
In  CREATE  no  calls  or  Iterates  could  be  placed.  This  Is  because  the 
Pr1nt_Hork  module  Is  used  throughout  the  HOCLL  system. 

4. 3. 3. 6.1  Walk  P  Tree  (Hodule  1.3.6.11. 

The  Halk_P_Tree  module  prints  the  Interconnection  port  Information 
to  the  terminal.  This  Is  accomplished  recursively  by  using  a  pointer  to 
the  1nter_ports  structure  and  then  passing  In  the  next  port  pointer  of 
the  structure  on  subsequent  calls  to  the  module  thereby  walking 
through  the  entire  linked  list. 


The  Malk_R_Tree  module  outputs  the  rectangle  structure  information 
to  the  terminal  one  layer  at  a  time.  To  do  this,  the  trinary  rectangle 
structure  trees  must  be  recursively  walked  to  ensure  no  rectangle  Is 
missed.  First  the  left  sub-tree  Is  traversed,  followed  by  the  middle, 
and  finally  the  right  sub-tree. 

4. 3. 3. 6. 3  Walk  W  Tree  f Module  1.3.6. 3). 

Walk_W_Tree  prints  only  the  Initial  starting  x  and  y  location  of 
the  wire  to  the  terminal  and  then  calls  another  module  (Segment_Tree 
Module  l.d.b.i.ij  to  aispiay  tne  wire  segments,  unce  again,  as  in  the 
rectangle  printing,  the  wire  structure  trinary  tree  Is  recursively 
walked. 

4. 3. 3. 6. 3.1  Segment  Tree  (Module  1.3.6.3.11. 

The  Segment.Tree  module  prints  each  segment  of  the  wire  statement, 
one  segment  at  a  time,  until  It  reaches  the  end  of  the  wire.  It  per¬ 
forms  this  recursively  by  passing  In  the  pointer  to  the  next  possible 
segment  location.  It  only  displays  the  width  and  layer  of  the  current 
segment  If  It  is  different  than  the  width  and  layer  of  the  previous 
segment,  which  are  also  Input  as  passed  parameters. 

4. 3. 3. 6. 4  Walk  Via  Tree  (Module  1.3.6.41. 

The  Wa1k_Via_Tree  outputs  the  via  structure  Information  to  the 


terminal  one  layer  at  a  time.  To  do  this  the  trinary  via  structure 
tree,  as  in  the  rectangle  structure  tree,  must  be  recursively  walked  to 


ensure  no  via  Is  missed.  First  the  left  sub-tree  Is  traversed.  follOMed 
by  the  middle,  and  finally  the  right  sub-tree. 


4. 3. 3. 6. 5  Walk  C  Tree  (Module  1.3. 6. 5). 

The  Halk_C_Tree  module  recursively  walks  the  cal l_statement  trinary 
tree.  This  tree  however  Is  based  on  the  cells  CIF  number.  This  Is 
accomplished  by  recursively  passing  In  the  pointer  to  first  the  left 
sub-tree,  the  middle  sub-tree,  and  then  the  right  sub-tree.  In  printing 
the  Information  some  translation  has  to  be  performed  to  display  the 
flipping  of  modules  and  the  rotating  of  modules  as  the  user  entered  the 
Information.  After  printing  each  call  statement,  the  module  then  prints 
all  portname  declarations  associated  with  that  call. 

4. 3. 3. 6. 6  Walk  I  Tree  (Module  1.3.6.61. 

Ihe  Walk_l_lree  module  Is  almost  Identical  to  the  Walk_C_Tree 
module.  The  only  difference  Is,  since  some  of  the  Information  needed 
for  the  Iterate  statement  Is  Identical  to  the  call,  the  Iterate  makes 
use  of  the  cal l_statement  structure.  Because  of  this  an  extra  pointer 
reference  Is  used  for  some  of  the  Information. 

4.3.3. 7  Save  Cell  (Hodule  1.3.7). 

The  Save_Cell  module  Is  used  throughout  the  HOCLL  system  to  save  a 
cell  from  Internal  memory  to  disk.  To  do  this  It  accepts  the  filename 
and  cell  name  as  passed  parameters.  It  first  constructs  an  argument 
consisting  of  the  filename,  the  cellname,  and  all  the  structure  pointers 
for  user  defined  Information  (5tore_Ptrs  Hodule  1.3. 7.1).  This  argument 
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The  Store_Ptrs  module  stores  the  pointers  needed  to  save  a  cell 
already  defined.  In  one  single  argument.  It  performs  this  task  by 
accepting  the  pointer  to  be  stored,  along  with  the  argument  to  be  passed 
to  SAVECELL,  and  the  last  position  entered  In  the  argument.  It  converts 
the  pointer  to  ASCII  and  then  attaches  the  ASCII  version  to  the  argu¬ 
ment.  The  argument  and  last  position  entered  Is  then  passed  back  the 
Save  Cell  module. 


4.4  gPM  Main  (Module  2.0). 

The  0PM  program  Is  used  to  delete  a  cel)  from  a  parent  cell  In  the 
hierarchy,  place  a  cell  Into  a  parent  cell,  or  move  the  position  of  a 
cell  In  the  parent  cell.  The  modules  of  the  0PM  program  library  are 
shown  In  Figure  4.3  and  described  In  the  following  paragraphs.  The  main 
module  performs  four  basic  functions.  It  first  obtains  the  name  of  the 
parent  cell  from  the  user  (Name_Cell  Module  1.1);  if  the  cellname 
requested  is  on  disk  then  this  parent  cell  is  brought  Into  main  memory 
(6et_Cell  Module  2.1).  otherwise  the  user  is  asked  if  a  new  parent  cell 
by  the  entered  name  Is  wanted  (Get_0pt1on  Module  1.2.1);  If  the  named 
cell  Is  the  correct  parent  cellname  then  the  menu  of  options  available 
Is  displayed  (DPM_Menu  Module  2.2).  and,  as  long  as  the  user  doesn't 
request  to  quit  the  system,  the  option  requested  Is  Implemented 
(D_Implement  Module  2.3). 
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—  Get_Cell  (Para  4.4.1) 

I—  In  File  (Para  4. 4. 1.1) 

I”  Get_Port  (Para  4. 4. 1.2) 

I—  Get_Rect  (Para  4. 4. 1.3) 
j--  Get_Mlre  (Para  4. 4. 1,4) 

I—  Get_V1a  (Para  4. 4. 1.5) 

I”  Get_Ca11  (Para  4.4, 1.6) 

I  I"  Get  C_Parameters  (Para  4. 4. 1.6.1) 

I—  Get_Iter"(Para  4. 4. 1.7) 

--  DPM_Menu  (Para  4.4.2) 

--  D_Implement  (Para  4.4.3) 

I 

I"  P1ace_Call  (Para  4. 4. 3.1) 

I  I—  Ca11_Parameters  (Para  4. 4. 3. 1.1) 

I  I—  Can_Tree  (Para  4.4.3. 1.2) 

I  I—  C_Port_Mames  (Para  4.4.3. 1.3) 

I  I—  Port_Call_Place  (Para  4. 4.3. 1.3.1) 

I 

I"  Mod_Cal1  (Para  4. 4. 3. 2) 

1 

|--  Iterate_Call  (Para  4. 4. 3. 3) 

1  I--  Iter_Parameters  (Para  4. 4. 3. 3.1) 

I  1--  Iter_Tree  (Para  4. 4. 3. 3. 2) 

I 

I--  Modjter  (Para  4. 4. 3, 3) 
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Figure  4.3  DPM  Program  Library  Modules 


4.4.1  Get  Cell  (Module  2.1). 

The  Get_Ce11  module  reads  a  cell,  which  the  calling  program  has 
already  confirmed  Is  on  the  disk,  from  disk  Into  main  memory.  It  per¬ 
forms  this  by  reading  the  file  one  line  at  a  time  (In_F11e  Module  2.1.1) 
and  examining  the  contents  of  the  line.  It  Is  looking  for  GIF  comment 
lines  describing  the  starts  of  the  different  types  of  statements  avail¬ 
able  and  also  the  GIF  end  of  cell  marker  ”E".  The  statements  able  to  be 
read  are  MIF  interconnection  ports  (Get_Port  Module  2.1.2),  rectangles 
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or  boxes  (Get_Rect  Module  2.1.3),  HIF  wire  statements  (Get_W1re  Module 
2.1.4),  MIF  via  statements  (Get_V1a  Module  2.1.5),  call  statements 
(Get_Ca11  Module  2.1.6),  and  MIF  Iterate  statements  (Get_Iter  Module 
2.1.7).  The  variable  "string"  Is  passed  to  each  of  these  modules  so  the 
maximum  size  of  the  string  being  Input  need  only  be  defined  In  one 
place.  Also  passed  to  the  modules  Is  the  pointer  to  the  file  to  be 
read. 

4.4. 1.1  In  File  (Module  2.1.1). 

The  In_F11e  module  gets  characters  from  the  file  specified  by  the 
Input  parameter  “fp"  until  It  matches  the  Input  parameter  designating 
the  character  to  be  found  (f1nd_char)  or  until  the  end  of  file  Is 
reached.  The  characters  are  placed  In  a  string  which,  upon  completion. 
Is  passed  back  to  the  calling  module. 

4. 4. 1.2  Get  Port  (Module  2.1.2). 

The  module  Get_Port  is  used  to  read  the  interconnection  port  defi¬ 
nitions  from  the  file  designated  by  the  Input  parameter  "fp"  until  It 
reaches  the  GIF  comment  line  signifying  the  end  of  the  port  definitions. 
After  determining  the  line  being  read  Is  a  port  definition  by  reading 
the  GIF  "94"  statement,  the  portname  Is  read  (In_F11e  Module  2.1.1). 

The  X  and  y  location  Is  read  (Get_Num  Module  1.3. 1.2)  and  finally  the 
port-layer  Is  read.  This  Information  Is  then  stored  In  the  1nter_ports 
structure  In  main  memory  {Port_Tree  Module  1.3. 1.3). 


The  Get_Rect  module  Is  used  to  read  the  rectangle  (or  box)  defini¬ 
tions  from  the  file  designated  by  the  Input  parameter  "fp”.  This  module 
starts  by  getting  the  first  character  of  the  next  line  of  the  file.  If 
the  character  signifies  the  start  of  a  comment  then  the  comment  line  Is 
read  (In_F11e  Module  2.1.1)  and  If  the  comment  signifies  the  end  of  the 
rectangle  definitions  the  module  Is  exited.  If  the  character  signifies 
a  new  layer  definition  then  the  layer  Is  read.  Lastly,  If  the  character 
signifies  a  rectangle  (or  box)  definition,  then  the  rectangle  height, 
length,  and  x  and  y  location  Is  obtained  (Get.Num  Module  1.3. 1.2). 
Finally  the  rectangle  Is  placed  In  the  proper  layer  rectangle  structure 
(Rect_Tree  Module  1.3.2. 1). 

4. 4. 1.4  Get  Hire  (Module  2.1.41. 

The  Get_M1re  module  reads  MIF  wire  statements  from  the  GIF  file 
specified  by  the  Input  parameter  "fp".  It  starts  by  reading  the  first 
word  of  a  GIF  comment  line  (In_F11e  Module  2.1.1).  If  this  first  word 
signifies  the  end  of  the  wire  statements  then  the  module  Is  exited.  If 
the  word  specifies  a  wire  statement  then  the  x  and  y  location  Is  read 
(Get_Num  Module  1.3. 1.2);  this  Information  Is  placed  In  the  wire  struc¬ 
ture  (S_VI1re_Tree  Module  1.3. 3.1);  and  while  there  are  more  segments 
defined,  the  segment  layer,  width,  direction,  and  length  are  Input  and 
then  placed  In  the  w1re_parameters  structure  associated  with  the  wire 
start  (Place_M1re_Parameters  Module  1.3. 3. 3). 
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The  Get_V1a  module  Is  used  to  Input  HIF  via  statements  by  reading 
GIF  box  (rectangle)  definitions  from  the  file  designated  by  the  Input 
parameter  "fp".  It  starts  by  reading  the  first  character  of  the  line. 

If  this  character  Is  a  comment  marker,  then  the  entire  line  Is  Input. 

If  the  line  signifies  the  end  of  the  via  definitions,  then  this  module 
Is  exited.  If  the  comment  line  Is  the  start  of  the  vlas  In  a  new  layer, 
then  while  there  are  more  vlas  In  this  layer,  the  vlas  x  and  y  loca¬ 
tions  are  read  In  and  the  via  Is  stored  In  the  proper  structure  of  via 
definitions  based  on  layer. 

4. 4. 1.6  Get  Call  (Module  2.1.8). 

The  Get.Call  module  Inputs  call  statements  from  the  file  designated 
by  the  input  parameter  "fp".  The  module  starts  by  reading  the  first 
word  of  the  next  line  (In_F11e  Module  2.1.1).  If  the  word  signifies  the 
end  of  the  call  statements,  then  this  module  is  exited.  If  the  first 
word  Is  the  start  of  a  HIF  call  comment,  then  the  cell  name,  x  and  y 
location,  and  the  bounds  of  the  called  cell  are  Input  (Get_Num  Module 
1.3. 1.2).  If  the  first  word  Is  the  start  of  a  GIF  call  statement,  then 
the  call  parameters  are  obtained  (Get_C_Parameters  Module  2. 1.6.1)  and 
the  parameters  from  the  MIF  call  comment  and  the  GIF  call  statement  are 
placed  In  the  cal l_statements  structure  (Call_Tree  Module  2. 3. 1.2).  If 
the  first  word  Is  a  port  definition,  then  the  port  name  Is  read  and 
placed  in  the  named_ports  structure  (Port_Cal l_Place  Module  2. 3. 2. 3.1). 


4. 4. 1.6.1  Get  C  Parameters  (Module  2.1.6.11. 

The  Get_C_Paraffleters  module  gets  call  parameters  from  the  file 
designated  by  the  input  parameter  "fp**.  It  first  obtains  the  GIF  number 
and  the  x  and  y  translational  position  of  the  cell  being  called  (Get_Num 
Module  1.3. 1.2).  Then,  the  mirroring  and  rotational  Information  Is 
decoded  from  the  GIF  call  statement  Into  the  HIF  form  for  storage.  This 
information  is  then  passed  back  to  the  calling  module 


4. 4. 1.7  Get  Iter  (Module  2.1.7). 

The  Get_Iter  module  is  very  similar  to  the  Get_Ga11  module.  It 
Inputs  iterate  statements  from  the  file  designated  by  the  input  parame¬ 
ter  "fp".  The  module  starts  by  reading  the  first  word  of  the  next  line 
(In_File  Module  2.1.1).  If  the  word  signifies  the  end  of  the  Iterate 
statements,  then  this  module  Is  exited.  If  the  first  word  is  the  start 
of  a  MIF  Iterate  comment,  then  the  cell  name,  number  of  Iterations  In 
the  X  and  y  direction,  the  x  and  y  pitch  or  spacing,  the  x  and  y  loca¬ 
tion,  and  the  bounds  of  the  iterated  cell  are  Input  (Get_Num  Module 
1.3. 1.2).  It  then  reads  characters  until  the  start  of  the  first  call 
statement  forming  the  iteration.  From  this  call  statement  the  parame¬ 
ters  which  make  up  a  call  are  obtained  (Get_G_Parameters  Module 
2. 1.6.1).  Then,  the  parameters  from  the  MIF  iterate  comment  and  the  GIF 
call  statement  are  placed  in  the  iter_statements  structure  (Iter_Tree 
Module  2. 3. 3. 2)  and  the  associated  call  statements  structure  (Gal1_Tree 
Module  2. 3. 1.2).  If  the  first  word  is  a  port  definition,  then  the  port 
name  is  read  and  placed  in  the  named_ports  structure  (Port_Gall_Place 
Module  2. 3. 2. 3. I). 


4.4.2  PPM  Henu  (Module  2.21. 

The  DPH_(1enu  module  displays  the  available  options  to  the  user  and 
then  requests  the  user  to  select  one  of  the  options  (Get_0pt1on  Module 
1.2.1)  based  on  a  one  character  entry.  It  accepts  the  cell  name  of  the 
parent  cell  as  Its  only  Input  simply  to  display  with  the  menu  so  as  to 
appear  more  friendly  to  the  user.  If  the  selected  character  Is  not  a 
valid  option,  an  error  message  stating  so  Is  printed  along  with  the 
menu.  The  user  Is  then  asked  to  choose  again.  Once  a  valid  option  Is 
obtained.  It  Is  passed  back  to  the  calling  module. 


4.4.3  0  Implement  f Module  2.31. 

The  0_lmplement  module  accepts  the  option  to  be  performed  (as 
obtained  from  the  DPM_Menu  module  and  the  parents  cell  name  as  Input 
parameters.  If  the  selected  option  Is  to  place  or  modify  a  call  or 
Iterate  statement,  the  name  of  the  cell  Is  first  obtained  (Name_Ce11 
Module  1.1)  and  the  CIF  number  Is  determined  (Det_Cifnum  Module  7.1). 

If  the  option  Is  to  place  a  call  or  Iterate  statement  and  the  file  named 
Is  on  disk,  then  the  bounds  are  obtained  from  the  disk  file.  If  the 
file  Is  not  on  disk,  the  user  Is  asked  If  the  cell  name  specified  Is 
correct  (Get_0pt1on  1.2.1).  If  the  cell  Is  on  disk,  or  Is  to  be  placed 
even  If  not  on  disk,  then  either  place  the  call  (P1ace_Call  Module 
2.3.1)  or  place  the  Iterate  statement  ( Iterate_Cal 1  Module  2.3.3)  Is 
executed  based  on  the  option  requested.  If  the  option  was  to  modify  or 
delete  a  call  or  Iterate  statement,  then  the  proper  module  Is  called 
(Mod_Ca11  Module  2.3.2  Mod_Iter  Module  2.3.4).  If  the  option  was  to 
print  the  work,  then  the  work  accomplished  and  stored  In  main  memory  for 


The  P1ace_Ca11  module  accepts  the  bounds.  CIF  number,  and  cellname 


from  the  calling  module.  It  then  gets  the  parameters  for  the  call 
statement  from  the  user  (Cal 1_Parameters  Module  2. 3. 1.1)  and  places  them 
In  the  cal 1_statements  structure  In  main  memory  (Ca11_Tree  Module 
2. 3. 1.2).  It  next  gets  the  port  names  associated  with  this  call  state¬ 
ment  (C_Port_Names  Module  2. 3. 1.3).  The  user  Is  then  asked  If  the 
present  cell  should  be  placed  In  another  location  and  If  not  this  module 
Is  exited  (Get_0pt1on  Module  1.2.1). 

4.4.3. 1.1  Call  Parameters  (Module  2.3.1.11. 

The  Cal 1_Parameters  module  obtains  the  parameters  needed  for  the 
call  statement  from  the  user.  It  accepts  the  cellname  from  the  calling 
module  to  display  with  the  questions  so  as  to  appear  more  friendly  for 
the  user.  It  obtains  the  x  and  y  location  of  the  bottom  left  corner  of 
where  the  cell  is  to  be  placed  (Get_Num  Module  1.3. 1.2),  and  then  deter¬ 
mines  If  the  cell  Is  to  be  flipped  upside  down  and/or  left  to  right  (In 
CIF  language  mirroring  Instructions).  Finally  the  user  may  rotate  the  x 
axis  of  the  cell  being  called  to  the  3.  6.  9,  or  12  o'clock  position. 
This  Is  consistent  with  the  CLL  language  for  laying  out  cells.  Upon 
saving  call  statements  (see  0ut_Ca11_Tree  Module  7.3.5),  this  Informa¬ 
tion  Is  ordered  In  the  CIF  call  statement  with  the  flipping  (mirroring) 
occurring  first,  the  rotation  taking  place  second,  and  then  finally  the 


translation.  The  translational  position  Is  adjusted  so  that  after  the 
flipping,  and  the  rotation,  the  new  final  bottom  left  corner  of  the  cell 
Is  placed  where  the  user  defined  the  bottom  left  corner  to  be. 


4.4.3. 1.2  Call  Tree  IHodule  2.3.1.21. 

The  Call_Tree  module  places  the  Information  for  the  call  statement 
In  the  next  available  cal 1_statefflent  location.  It  accepts  the  cellname, 
CIF  number,  translation,  mirroring,  rotation,  bounds,  and  a  pointer  to 
the  next  cal l.statement  location  as  Input  parameters.  If  the  location 
defined  by  the  pointer  already  has  a  call  statement  residing  In  It,  then 
this  module  Is  recursively  called.  If  the  CIF  number  of  the  cell  to  be 
placed  Is  greater  than  the  CIF  number  of  the  present  call,  then  the  left 
tree  pointer  Is  used  as  the  subsequent  Input.  If  the  CIF  number  of  the 
cell  to  be  placed  Is  equal  to  the  present  CIF  number,  then  the  middle 
tree  pointer  Is  used.  Finally,  If  the  CIF  number  Is  greater,  then  the 
right  tree  pointer  Is  used.  After  a  location  Is  found  which  Is  not 
defined,  this  module  allocates  space  and  the  Information  Is  loaded  Into 
the  cal1_statement  structure. 

4.4.3. 1.3  C  Port  Names  (Module  2.3.1.31. 

The  module  C_Port_Names  allows  the  user  to  define  as  many  portnames 

as  needed  to  be  associated  with  the  call  statements.  The  user  simply 
enters  the  port  name  which  Is  then  placed  In  the  named_port  structure 
with  the  call  statement  (Port_Ca1 1_P1ace  Module  2. 3. 1.3.1).  The  user  Is 
then  asked  If  any  more  ports  are  to  be  defined  and  If  not  the  module  Is 
exited  (Get_0pt1on  1.2.1). 


4. 4. 3. 1.3.1  Port  Call  Place  (Module  2.3.1.3.11. 


The  Port_Ca1 1_P1ace  module  accepts  the  portname  and  pointer  to  the 
next  port  location  as  Inputs.  If  the  location  Is  already  filled,  then 
the  module  Is  recursively  called  using  the  next  port  location  as  Input 
until  an  empty  location  Is  found.  Once  an  empty  location  Is  found, 
memory  space  Is  allocated  and  the  portname  Is  stored  In  the  named_ports 
structure. 

4. 4. 3. 2  Mod  Call  (Module  2.3.21. 

The  Mod_Ca11  module  allows  the  user  to  modify  or  delete  call  state¬ 
ments  already  defined.  It  accepts  as  Input  an  exit  control  flag,  a  GIF 
number,  and  a  pointer  to  the  next  call  statement.  If  the  location 
defined  by  the  pointer  is  not  empty  and  the  exit  flag  Is  false,  then  the 
module  checks  If  the  Input  GIF  number  Is  less  than  or  equal  to  the 
present  GIF  number  (this  Is  done  so  the  user  need  not  enter  the  cellname 
to  be  modified,  which  Is  then  translated  to  the  GIF  number,  to  modify 
the  call  statements).  If  the  GIF  number  Is  valid,  then  the  call  state¬ 
ment  Is  displayed  for  the  user.  The  user  may  then  either  modify  this 
call  statement,  delete  this  call  statement,  go  to  the  next  call  state¬ 
ment,  or  exit  this  module  (Get_0pt1on  Module  1.2.1).  If  the  option  Is 
to  exit  the  module  then  the  exit  flag  Is  set  to  true  and  the  module  Is 
exited.  If  the  option  Is  to  delete  the  call  statement,  then  the  call  Is 
deleted  by  setting  the  y  translation  parameter  to  ”-9999".  (The  struc¬ 
ture  definition  needs  to  be  maintained  with  the  GIF  number  to  keep  the 
trinary  tree  structure  Intact  without  massive  reorganization  of  the 
other  called  cells.)  If  the  option  is  to  modify  the  call  statement. 
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then  all  the  call  parameters  must  be  re-entered  (Cal 1_Parameters  Module 
2. 3. 1.1).  After  each  call  statement  the  user  can  modify  or  delete  the 
port  names  associated  with  the  call  (C_Port_Names  Module  2. 3. 1.3).  The 
options  continue  until  all  the  call  statements  have  been  processed  or 
the  exit  command  Is  given. 

4. 4.3.3  Iterate  Call  (Module  2.3.3). 

The  Iterate_Can  module  Is  very  simplistic.  It  accepts  the  bounds, 
CIF  number,  and  cellname  as  input  and  simply  calls  five  other  modules. 
First  It  gets  the  call  parameters  associated  with  this  iterate  statement 
(Ca11_Parameters  Module  2. 3. 1.1).  It  then  obtains  the  Iteration  parame¬ 
ters  ( Iter_Parameters  Module  2. 3. 3.1),  places  the  Iteration  parameters 
In  the  1 ter_statement  structure  (Iter_Tree  Module  2. 3. 3.2),  and  the 
associated  call  statement  parameters  In  the  associated  cal1_statement 
structure  (Ca11_Tree  Module  2. 3. 1.2).  Finally,  It  gets  the  port  names 
to  be  associated  with  this  Iteration  (C_Port_Names  Module  2. 3. 1.3). 

4. 4. 3. 3.1  Iter  Parameters  (Module  2.3.3. 1). 

The  module  Iter_Parameters  allows  the  user  to  Input  the  parameters 
for  Iterating  a  cell.  The  bounds  of  the  cell  are  passed  Into  this 
module.  First  the  user  is  requested  to  enter  the  number  of  Iterations 
in  the  x  and  y  direction  (6et_Num  Module  1.3. 1.2).  Then  the  user  may 
define  an  x  and  y  pitch,  or  spacing,  for  the  iterated  cells  or  default 
to  the  size  of  the  bounding  box  as  determined  by  the  bounds  Input  to 
this  module.  The  Iteration  and  the  pitch  Information  are  then  passed 
back  to  the  calling  module. 


4. 4. 3. 3. 2  Iter  Tree  (Module  2.3.3. 2 


The  Iter_Tree  module  places  the  (nformatfon  for  the  Iterate  state¬ 
ment  In  the  next  available  1 ter_statefflent  location.  It  accepts  the 
cel (name,  CIF  number,  number  of  Iterations  In  the  x  and  y  direction,  the 
X  and  y  pitch,  and  a  pointer  to  the  next  1ter_statefflent  structure  as 
Input  parameters.  If  the  location  defined  by  the  pointer  already  has  an 
Iteration  residing  In  It,  then  this  module  Is  recursively  called.  If 
the  CIF  number  of  the  cell  to  be  Iterated  is  greater  than  the  CIF  number 
of  the  present  Iterated  cell,  then  the  left  tree  pointer  Is  used  as  the 
subsequent  Input.  If  the  CIF  number  of  the  cell  to  be  Iterated  Is  equal 
to  the  present  CIF  number,  then  the  middle  tree  pointer  Is  used.  If  the 
CIF  number  Is  greater,  then  the  right  tree  pointer  Is  used.  Once  a  non- 
deflned  location  Is  found,  the  module  allocates  space  and  the  Informa¬ 
tion  Is  loaded  Into  the  1ter_statement  structure. 

4. 4. 3. 4  Mod  Iter  (Module  2.3.41. 

The  Hod_Iter  module  allows  the  user  to  modify  or  delete  Iterate 
statements  previously  defined.  It  accepts  as  Input  an  exit  control 
flag,  a  CIF  number,  and  a  pointer  to  the  next  Iterate  statement.  If  the 
location  defined  by  the  pointer  Is  not  empty  and  the  exit  flag  Is  false, 
then  the  module  checks  If  the' Input  CIF  number  Is  less  than  or  equal  to 
the  present  CIF  number  (this  Is  done  so  the  user  need  not  enter  the 
cellname  of  the  Iteration  to  be  modified!  which  Is  translated  to  the  CIF 
number,  to  modify  Iterate  statements).  If  the  CIF  number  to  be  found  Is 
less  than  or  equal  to  the  CIF  number  of  the  Iteration  statement  being 
examined,  then  the  Iterate  statement  Is  displayed  for  the  user.  The 


user  may  then  either  modify  or  delete  this  iteri.te  statement,  go  to  the 
next  iterate  statement,  or  exit  this  module  (Get_0pt1on  Module  1.2.1). 

If  the  option  is  to  exit  the  module,  then  the  exit  flag  Is  set  to  true 
and  the  module  is  exited.  If  the  option  is  to  delete  the  iterate 
statement,  then  the  iteration  is  deleted  by  setting  the  number  of  x 
iterations  to  “-SSSS".  (The  structure  needs  to  be  maintained  with  the 
GIF  number  to  keep  the  trinary  tree  structure  intact  without  massive 
reorganization  of  the  other  iterations.)  If  the  option  is  to  modify  the 
iterate  statement,  then  all  the  iterate  parameters  and  the  associated 
call  parameters  must  be  re-entered  ( Iter_Parameters  Module  2.3.3. 1  and 
Cal 1_Parameters  Module  2. 3.1.1).  After  each  iterate  statement  the  user 
can  modify  or  delete  the  port  names  associated  with  that  iteration 
(C_Port_Mames  Module  2. 3. 1.3).  The  options  continue  until  all  of  the 
iterate  statements  have  been  processed  or  the  exit  command  is  given. 

4.5  MODIFY  Main  (Module  3.0). 

The  MODIFY  program  is  used  to  modify  a  previously  defined  cell. 

The  main  program  first  obtains  the  name  of  the  cell  to  be  modified  from 
the  user  (Name_Cell  Module  1.1).  If  the  cell  can't  be  found  on  disk, 
the  user  is  asked  if  he  wants  to  try  again  (Get_0ption  Module  1.2.1). 

If  not,  the  program  is  exited.  Once  a  valid  file  is  obtained  the  cell 
is  read  into  main  memory  from  disk  (Get_Cell  Module  2.1).  Next,  it  is 
determined  if  the  user  wants  to  add  to  this  cell,  modify  (or  delete) 
cell  parameters,  or  quit  to  the  system  (0et_Mod  Module  3.1).  If  the 
user  wants  to  add  to  the  module  then  the  menu  used  for  creating  a  cell 
is  displayed  (C_Menu  Module  1.2)  and  while  the  selected  option  is  other 


than  to  quit,  the  option  Is  Implemented  (Implement  Module  1.3).  On  the 
other  hand.  If  the  user  wants  to  modify  the  cell  a  menu  Is  displayed 
showing  the  options  available,  and.  while  the  option  Is  other  than  to 
quit,  the  option  Is  Implemented  (H_Imp1ement  Module  3.3).  The  modules 
of  the  MODIFY  program  library  are  shown  In  Figure  4.4  and  are  described 
In  the  following  paragraphs. 

MODIFY  Main 

I 

I”  Det_Mod  (Para  4.5.1) 

I 

1"  M_Menu  (Para  4.5.2) 

I 

I”  M_Imp1ement  (Para  4.5.3) 

I 

I"  Mod_Port  (Para  4.5.3. 1) 

I”  Mod  Rect  (Para  4.5. 3. 2) 

I"  Mod_Mlre  (Para  4. 5. 3. 3) 

I—  Mod  Via  (Para  4. 5.3. 4) 

I—  Mod_Flash  (Para  4. 5. 3. 5) 

Figure  4.4  MODIFY  Program  Library  Modules 


4.5.1  Pet  Mod  (Module  3.1). 

The  Det_Mod  module  allows  the  user  the  selection  of  adding  to  a 
cell,  modifying  a  cell,  or  quitting  to  the  operating  system  based  on  a 
one  character  entry  (Get_0pt1on  Module  1.2.1).  If  the  selected  charac¬ 
ter  Is  not  a  valid  option  then  the  user  Is  so  told  and  requested  to 
select  again.  Once  a  valid  option  Is  selected  the  option  Is  passed  back 
to  the  calling  module. 


4,5.2  M  Menu  (Module  3,2). 

The  H_Menu  module  displays  the  available  options  to  the  user  and 
then  requests  the  user  to  pick  one  of  the  options  (Get_0pt1on  Module 
1.2.1)  based  on  a  one  character  entry.  It  accepts  the  cel (name  as  Its 
only  Input  simply  to  display  with  the  menu  so  as  to  appear  more  friendly 
to  the  user.  If  the  selected  character  Is  not  a  valid  option  an  error 
message  stating  so  Is  printed  along  with  the  menu  and  the  user  Is  asked 
to  choose  again.  Once  a  valid  option  Is  obtained.  It  Is  passed  back  to 
the  cal  1 1ng  module. 


4.5.3  M  Implement  (Module  3,3). 

The  module  M_Imp1ement  accepts  the  option  to  be  performed,  the 
filename,  and  the  cellname  as  Input  parameters.  If  the  option  Is  to 
print,  then  the  cell,  as  currently  stored  In  memory  as  opposed  to  the 
version  on  disk.  Is  displayed  to  the  user  {Pr1nt_Mork  Module  1.3.6).  If 
the  option  Is  to  save  the  cell  to  disk,  then  the  cell  as  currently 
stored  In  memory  Is  saved  (Save_Cell  Module  1.3.7).  If  the  user  wants 
to  modify  a  statement,  other  than  a  call.  Iteration,  or  wire,  the  layer 
needs  to  be  determined  (Def_Layer  Module  1.3. 1.1)  and  an  optional  x 
location  (Get_Num  Module  1.3. 1.2),  which  Is  used  to  go  directly  to  the 
statement  to  be  modified.  If  the  user  wants  to  modify  port  definitions 
for  this  cell,  then  the  modify  port  module  Is  called  (Mod_Port  Module 
3.3.1).  If  the  user  wants  to  make  modifications  to  the  rectangles 
defined,  then  call  the  modify  rectangle  module  with  the  proper  layer 
structure  in  which  they  are  defined  (Mod_Rect  Module  3.3.2).  If  the 
option  Is  to  modify  a  wire,  then  enter  the  module  to  modify  a  wire 
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(Mod_M1re  3.3.3).  If  the  option  Is  to  modify  a  via,  then  enter  the 
modify  via  module  with  the  tree  structure  of  the  layer  of  vlas  requested 
(Def_V1a  Hodule  3.3.4).  Finally  If  a  flash  needs  modification,  then 
enter  the  module  to  modify  round  flashes  (Hod_F1ash  Hodule  3.3.5). 

4.5.3. 1  Hod  Port  (Hodule  3.3.1). 

The  Hod_Port  module  allows  the  user  to  modify  or  delete  previously 
defined  Interconnection  ports.  This  module  accepts  a  pointer  to  the 
next  1nter_ports  structure  as  Input,  and  If  there  Is  a  port  at  that 
location,  the  port  parameters  are  displayed  to  the  user.  The  user  may 
then  either  exit  this  module,  delete  the  port  definition  displayed, 
modify  the  port,  or  go  to  the  next  port  In  the  structure.  If  the  option 
Is  to  delete  the  port  then  the  y  location  of  the  port  Is  set  to  "-9999" 
(since  the  location  In  the  structure  must  be  maintained  to  avoid 
reorganization  of  the  subsequent  port  definitions).  If  the  user  wants 
to  modify  the  port,  then  the  new  portname,  layer  (Oef_Layer  Hodule 
1.3. 1.1),  and  x  and  y  location  (Get_Num  Hodule  1.3. 1.2)  are  defined.  If 
the  option  selected  was  other  than  to  exit  this  module,  the  module  Is 
recursively  called  with  the  next  port  location  until  the  1nter_ports 
structure  Is  exhausted. 

4. 5. 3.2  Hod  Rect  (Hodule  3.3.2). 

The  Hod_Rect  module  allows  the  user  to  modify  or  delete  rectangle 


definitions  previously  entered.  It  accepts  as  Input  an  exit  control 
flag,  an  x  location,  and  a  pointer  to  the  next  rectangle  In  the  struc¬ 
ture.  If  the  location  defined  by  the  pointer  Is  not  empty  and  the  exit 


flag  Is  false,  then  the  module  checks  If  the  Input  x  location  Is  less 
than  or  equal  to  the  present  rectangle's  x  location  (this  Is  performed 
so  the  user  may  step  through  all  the  rectangles  If  desired,  or  simply  go 
directly  to  the  rectangle  to  be  modified).  If  the  x  location  to  be 
found  Is  less  than  or  equal  to  the  x  location  of  the  rectangle  statement 
being  examined,  then  the  rectangle  statement  Is  displayed  for  the  user. 
The  user  may  then  either  modify  this  rectangle,  delete  this  rectangle, 
go  to  the  next  rectangle  In  the  structure,  or  exit  this  module 
(Get_0pt1on  Module  1.2.1).  If  the  option  Is  to  exit  the  module,  then 
the  exit  flag  Is  set  to  true  and  the  module  Is  exited.  If  the  option  Is 
to  delete  the  rectangle,  then  the  rectangle  Is  deleted  by  setting  the 
height  and  length  of  the  rectangle  to  zero.  (The  structure  needs  to  be 
maintained  with  the  x  location  to  keep  the  trinary  tree  structure  Intact 
without  massive  reorganization  of  the  other  rectangles  In  this  layer.) 

If  the  option  Is  to  modify  the  rectangle,  then  the  height,  length,  and  x 
and  y  location  of  the  rectangle  must  be  re-entered  (Get_Num  Module 
1.3. 1.2).  If  the  X  location  has  changed,  then  the  rectangles  present 
location  is  deleted  as  described  above  and  a  new  rectangle  is  placed  In 
the  structure  (Rect_Tree  Module  1.3. 2.1).  The  options  continue  until 
all  the  rectangles  In  the  structure  have  been  processed  or  the  exit 
command  Is  given. 

4. 5. 3. 3  Mod  Hire  (Module  3.3.3). 


The  Mod_W1re  module  allows  the  user  to  modify  or  delete  wire  state¬ 
ments  previously  entered.  It  accepts  as  Input  an  exit  control  flag,  an 
X  location,  and  a  pointer  to  the  next  wire  statement  In  the  structure. 


Once  a  valid  wire  Is  found,  by  use  of  the  Input  x  location  as  described 
In  the  previous  paragraph,  the  wire  statement  Is  displayed.  The  user 
may  then  either  modify  this  wire,  delete  this  wire,  go  to  the  next  wire 
In  the  structure,  or  exit  this  module  (Get_0pt1on  Module  1.2.1).  If  the 
option  Is  to  exit  the  module,  then  the  exit  flag  Is  set  to  true  and  the 
module  Is  exited.  If  the  option  Is  to  delete  the  entire  wire,  then  the 
wire  Is  deleted  by  erasing  the  segments  associated  with  this  wire  start. 
(The  structure  needs  to  be  maintained  with  the  x  location  to  keep  the 
tr Inary  tree  structure  Intact  without  massive  reorganization  of  the 
other  wires.)  If  the  option  Is  to  modify  the  wire,  then  the  new  x  and 
y  location  of  the  wire  start  Is  obtained  (Get_Num  Module  1.3. 1.2).  If 
the  X  location  has  changed,  then  the  wire's  present  location  Is  deleted 
as  described  above  and  a  new  wire  Is  placed  In  the  structure 
(S_M1re_Tree  Module  1.3. 3.1)  along  with  all  of  Its  previously  defined 
segments  (P1ace_M1re_Parameters  Module  1.3. 3. 3).  If  the  x  location 
hasn't  changed,  then  one  at  a  time  the  user  may  modify  the  Individual 
segments'  width,  length,  and/or  layer.  The  options  continue  until  all 
the  wires  In  the  structure  have  been  processed  or  the  exit  command  Is 
given. 


via,  delete  this  via,  go  to  the  next  via  In  the  structure,  or  exit  this 
module  (Get_0pt1on  Module  1.2.1).  If  the  option  Is  to  exit  the  module, 
then  the  exit  flag  Is  set  to  true  and  the  module  Is  exited.  If  the 
option  Is  to  delete  the  via,  then  the  via  Is  deleted  by  setting  the  y 
location  of  the  via  to  “-SSSS".  If  the  option  Is  to  modify  the  via 
then  the  x  and  y  location  of  the  via  must  be  re-entered  (Get_Num  Module 
1.3. 1.2).  If  the  X  location  has  changed,  then  the  vla's  present  loca¬ 
tion  Is  deleted  as  described  above  and  a  net*  via  Is  placed  In  the 
structure  (V1a_Tree  Module  1.3. 4.1).  The  options  continue  until  all  the 
Vlas  In  the  structure  have  been  processed  or  the  exit  command  Is  given. 


4. 5. 3. 5  Mod  Flash  (Module  3.3.5). 

The  Mod_F1ash  module  Is  not  yet  Implemented.  It  should  be  very 
similar  to  the  Mod_Rect  module  except  the  modifications  would  be  to 
those  parameters  defining  a  round  flash.  In  particular  the  x  and  y 
location  and  the  diameter  of  the  flash  would  have  to  be  allowed  to  be 
modified  or  the  entire  flash  deleted. 

4.6  INTER  Main  (Module  4,0). 

The  INTER  program  Is  Intended  to  be  used  to  Interconnect  the  cells 
In  a  circuit.  It  has  not  yet  been  Implemented.  It  Is  envisioned  to 
allow  the  user  to  route  not  only  single  wires,  but  also  bus  lines, 
around  a  circuit  more  easily  than  placing  the  wires  one  at  a  time  with 
the  wire  statement  as  Is  currently  suggested  In  the  MDCLL  system.  It  Is 
also  hoped  that  an  automated  router  can  be  configured  Into  this  system. 
In  either  case,  the  use  of  the  Interconnection  ports  should  provide  an 
easier  method  for  connecting  the  cells  making  up  a  circuit. 
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4.7  PRIPLO  Main  (Module  5.0). 

The  PRIPLO  program,  presently,  only  performs  one  function.  This  Is 
to  print  a  cell's  file  as  contained  on  disk  to  the  user's  terminal.  It 
Is  envisioned,  however,  that  this  program  should  be  expanded  to  also 
allow  the  file  to  be  output  to  a  printer.  Also,  the  program  should 
provide  for  the  quick  plotting  of  a  simple  bounding  box  type  plot  of  a 
cell  to  a  standard  printer  (so  any  printer  could  handle  the  output, 
using  only  the  standard  character  set).  Admittedly  this  would  cause 
some  of  the  detail  to  be  lost,  but  quite  often  the  user  simply  needs  an 
overall  picture  of  the  cell  In  question. 

4.8  FINALIZE  Main  (Module  6.01. 

The  FINALIZE  program  Is  used  to  combine  all  the  cells  referenced 
(called  or  Iterated),  by  the  highest  level  cell  In  a  design.  Into  one 
file  for  subsequent  plotting  using  MCIFPLOT  or  to  be  sent  off  for  pro¬ 
duction.  The  modules  In  the  FINALIZE  program  library  are  shown  In 
Figure  4.4  and  described  In  the  paragraphs  below.  First,  the  user  must 
enter  the  name  of  the  cell  to  be  finalized  (Name_Ce11  Module  1.1).  If 
the  file  Is  not  found  on  disk  the  user  Is  given  the  option  of  trying 
again  (Get_0pt1on  Module  1.2.1).  If  the  file  Is  on  disk  then  the  cell's 
calls  to  other  cells  and  Iterations  of  other  cells  must  be  obtained  and 
stored  for  later  processing  (In_Fne  Module  2.1.1,  Get_Call  Module 
2.1.6,  and  Get_Iter  Module  2.1.7).  Once  all  the  references  to  other 
cells  are  obtained  from  the  cell  to  be  finalized,  the  final  GIF  Is  then 
formatted  (Format_C1f  Module  6.1).  Finally  control  Is  returned  to  the 
MOCLL  program  (MDCLL  Main  Module  0.0). 
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FINALIZE  Main 

I 

|--  Format_C1f  (Para  4.8.1) 


--  Pr1mary_Cans  (Para  4.8. 1.1) 

I”  Ca11_Names  (Para  4. 8. 1.1.1) 

"  Iter_Cans  (Para  4. 8. 1.2) 

"  Process_Call  (Para  4. 8. 1.3) 


Figure  4.5  FINALIZE  Program  Library  Modules 


4.8.1  Format  Clf  (Module  6.1). 

The  module  Format_C1f  accepts  the  filename  and  cell  name  of  the  cell 
to  be  finalized.  It  then  places  all  the  cellnames  of  the  primary  calls 
and  the  primary  Iterated  calls  Into  a  single  linked  list.  (Pr1mary_Ca1 Is 
Module  6.1.1  and  Iter_Ca11s  Module  6.1.2).  The  linked  list  of  cellnames 
Is  then  processed  by  reading  the  file  from  disk,  placing  any  called  or 
Iterated  cells  names  Into  the  linked  list,  and  writing  the  file  to  the 
"final. clf"  file  on  disk.  While  there  are  more  cellnames  In  the  called 
cells  linked  list,  the  referenced  cell  Is  processed  In  this  manner 
(Process_Cal 1  Module  6.1.3).  Finally,  the  parent  cell  being  finalized 
Is  written  to  the  "final. clf"  file  (In_F11e  Module  2.1.1  and  0ut_F11e 
Module  7.2.1). 


4. 8. 1.1  Primary  Calls  (Module  6.1.1). 

The  Pr1mary_Ca1 Is  module  Is  very  simplistic.  It  accepts  a  pointer 
to  the  next  call  statement  as  Input  and  recursively  steps  through  the 
cal 1_statement  structure  placing  the  called  cells  names  Into  the  ca11ed_ 
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cells  linked  list  structure  (Ca11_Names  Hodule  6. 1.1.1).  This  module 
need  only  process  the  called  cells  with  CIF  numbers  either  greater  than 
or  less  than  the  previous  cell  since  no  duplication  of  cells  Is  needed. 

4. 8. 1.1.1  Call  Names  (Hodule  6.1. 1.1). 

The  Call.Names  module  accepts  a  cellname.  CIF  number,  and  pointer 
to  the  next  called  name  as  Input.  The  module  then  searches  for  either 
an  already  existing  storage  of  the  cell  being  referenced,  or  If  there  Is 
no  previous  reference,  then  memory  Is  allocated  and  the  ceilname  and  CIF 
number  are  stored  In  the  ca11ed_ce11s  structure.  In  this  manner,  each 
called  cell  Is  only  defined  once  In  the  final  CIF  file  regardless  of  the 
number  of  times  It  Is  Invoked. 

4.8. 1.2  Iter  Calls  (Module  6.1.2). 

The  Iter_Ca11s  module  Is  very  simplistic  and  Is  Identical  to  the 
Pr1mary_Ca11s  module,  except  that  It  walks  the  1 ter_statement  structure. 
It  accepts  the  pointer  to  the  next  Iterate  statement  as  Input  and  recur¬ 
sively  steps  through  the  1 ter_statement  structure  placing  the  Iterated 
cells  names  Into  the  cal1ed_ce11s  linked  list  structure  (Ca11_Names 
Hodule  6. 1.1.1).  This  module  need  only  process  the  Iterated  cells  with 
CIF  numbers  either  greater  than  or  less  than  the  previously  processed 
cell  since  no  duplication  of  cells  Is  needed. 
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4. 8. 1.3  Process  Call  (Hodule  6.1.3). 

The  Process_Call  module  accepts  the  cellname  to  be  processed  and 
the  file  pointer  to  the  "final. clf"  file  to  which  the  cell  should  be 
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written  as  Input  via  passed  parameters.  It  then  converts  the  cell  name 
to  the  needed  filename  and  opens  the  cell's  file  to  be  processed.  If 
the  file  can't  be  opened,  the  user  Is  asked  If  the  module  should  try  to 
open  the  file  again,  thereby  allowing  a  change  of  disks  (Get_0pt1on 
Module  1.2.1).  Once  the  file  Is  opened,  the  file  Is  copied,  one  line  at 
a  time,  to  the  "final .elf  file  (In_f11e  Module  2,1.1  and  0ut_F11e 
Module  7.2.1).  If  the  line  processed  Is  either  a  reference  to  a  call 
statement  or  an  Iteration,  then  the  associated  cellname  and  GIF  number 
are  added  to  the  ca11ed_names  structure  (Ca11_Names  Module  6. 1.1.1  and 
Det_C1fnum  Module  7.1). 

4.9  SAVECELL  Main  (Module  7.0). 

The  SAVECELL  program  Is  used  to  save  a  cell  from  main  memory  to 
disk.  It  accepts  as  Input,  a  single  string  argument  which  contains  the 
filename,  cellname,  and  pointers  to  the  structures  to  be  converted  to 
CIF  and  saved  to  disk.  The  program  performs  four  basic  functions:  It 
determines  the  CIF  number  of  the  cell  to  be  saved  (Det_C1fnum  Module 
7.1);  It  then  writes  the  CIF  header  to  the  file  on  disk  (Header_0ut_F1 1e 
Module  7.2);  the  CIF  cell  layout  Is  then  written  to  the  file  (0ut_Cell_ 
Layout  Module  7.3);  finally,  the  CIF  footer  Is  written  to  the  file  on 
disk.  After  completing  the  cell,  the  MDCLL  program  Is  executed  (MDCLL 
Main  Module  0.0).  The  modules  In  the  SAVECELL  program  library  are 
shown  In  Figure  4.5  and  are  described  In  the  following  paragraphs. 


SAVECELL  Main 


"  Det_C1fnum  (Para  4.9.1) 

—  Header_Out_File  (Para  4.9.2) 

I"  Out_Flle  (Para  4.9.2. 1) 

--  Out_Ce1 l_Layout  (Para  4.9.3) 

I 

|—  Out_Port_Tree  (Para  4.9.3. 1) 

I--  Out_Rect_Tree  (Para  4. 9. 3. 2) 

I”  Out_M1re_Tree  (Para  4. 9. 3. 3) 

I  |--  Out_W_Conment  (Para  4.9.3.3.1) 

1  I—  Out_H_Segment  (Para  4. 9. 3. 3. 2) 
I—  Out_V1a  Tree  (Para  4. 9. 3. 4) 

I--  Out_CalT_Tree  (Para  4. 9. 3. 5) 

I  I--  Out_C_Statement  (Para  4.9.3.5.1) 

I  1—  Out_P_Mames  (Para  4. 9. 3. 5. 2) 

I--  Out_Iter_Tree  (Para  4. 9. 3. 6) 

"  Footer_Out_Fne  (Para  4.9.4) 


Figure  4.6  SAVECELL  Program  Library  Modules 


4.9.1  Pet  Cifnum  (Module  7.1). 

The  module  0et_C1fnum  determines  the  CIF  number  for  the  cell.  It 
performs  this  task  by  accepting  the  name  of  the  cell  as  an  Input  parame 
ter  and  then,  one  letter  at  a  time,  creating  an  Integer  based  on  the 
value  and  the  position  of  the  character.  It  then  Insures  that  this 
Integer  Is  non-negative  and  Is  greater  than  one  thousand.  The  final 
calculated  CIF  number  Is  then  returned  to  the  calling  program. 


4.9.2  Header  Out  File  (Module  7.2) . 

The  Header_Out_F 1 1 e  sets  up  the  starting  Information  needed  to 
define  a  CIF  cell.  This  Includes  a  "DS"  (or  Definition  Start)  state¬ 
ment,  followed  by  the  CIF  number,  and  scaling  factor  of  CIF  to  lambda 
units.  Then  a  comment  Is  Included  giving  the  title  of  the  cell. 


Out_F11e  accepts  two  strings  and  a  pointer  to  the  file  to  be  writ¬ 
ten  to  as  input  parameters.  It  first  outputs  the  one  string,  and  then 


the  other  to  the  file  specified.  This  module  was  implemented  in  this 
manner  since  it  seemed  every  time  this  module  was  invoked  a  variable  and 
a  separator,  of  more  than  one  character,  had  to  be  output.  This  method 
reduced,  by  two,  the  number  of  calls  to  this  module. 

4.9.3  Out  Cell  Layout  (Module  7.31 . 

Out_Cel l_Layout  controls  the  output  of  the  cell  to  the  file  desig¬ 
nated  by  the  input  parameter  “fp**.  It  first  outputs  any  ports  that  are 
defined  in  the  lnter_ports  structure  (Out_Port_Tree  Module  7.3.1).  It 
then  outputs  the  rectangles  defined,  one  layer  at  a  time  (Out_Rect_Tree 
Module  7.3.2).  It  then  outputs  the  MIF  wire  comments  (0ut_W1re_Tree 
Module  7.3.3).  This  is  followed  by  the  rectangles  which  make  up  the 
wire  statements,  once  again  output  one  layer  at  a  time  (Out_Rect_Tree 
Module  7.3.2).  Then  the  vias  making  up  the  wire  statements  are  output 
(0ut_V1a_Tree  Module  7.3.4).  Since  there  are  three  layers  associated 
with  each  via  defined  in  a  given  layer,  the  vias  are  output  by  the  layer 
in  which  they  are  defined  and  each  of  the  three  layers  associated  with 
the  vias.  This  causes  a  few  extra  CIF  layer  definition  statements,  but 
the  output  routine  is  consistent  with  the  construction  of  the  via. 

Next,  the  vias  defined  by  the  user  are  output  to  the  file  (Out_Via_Tree 
Module  7.3.4)  followed  by  the  call  statements  contained  in  the  ca11_ 
statements  structure  (Out_Cal 1_Tree  Module  7.3.5),  and  finally  the 
Iterate  statements  (Out_Iter_Tree  Module  7.3.6). 


4,9.3. 1  Out  Port  Tree  (Module  7.3.1 


The  Out_Port_Tree  module  recursively  steps  through  the  inter_ports 
structure  outputting  all  the  ports  which  were  not  deleted.  It  accepts 
the  pointer  to  the  next  port  location  and  the  pointer  to  the  output  file 
as  passed  parameters.  To  output  a  port.  It  first  outputs  a  "94",  signi¬ 
fying  a  statement  to  be  printed,  followed  by  the  x  and  y  location  and 
the  layer  of  the  port. 

4. 9. 3. 2  Out  Rect  Tree  (Module  7,3.21. 

The  module  Out_Rect_Tree  accepts  the  pointer  to  the  next  rectangle 
structure  and  the  pointer  to  the  output  file  as  Input  parameters.  If 
the  rectangle  hasn't  been  deleted,  then  the  GIF  box  statement  is  output 
to  the  file.  This  Includes  the  x  and  y  location  of  the  middle  of  the 
rectangle,  the  height  of  the  rectangle,  and  the  length  of  the  rectangle. 
Then,  if  needed,  the  bounds  of  the  cell  are  adjusted.  The  trinary 
rectangle  tree  structure  Is  recursively  walked  until  all  rectangles  have 
been  processed. 

4. 9. 3. 3  Out  Hire  Tree  (Module  7.3.3). 

The  Out_Mire_Tree  module  accepts  the  pointer  to  the  next  wire 
statement  and  the  pointer  to  the  output  file  as  Input  parameters.  It 
outputs  a  Lii-  commenc  line  containing  tne  start  or  tne  wire  Tol  towed  by 
the  wire  segments  (Uut_H_Lomment  nodule  /. 3.3.1),  and  then  processes  the 
MDCLL  wire  statement  into  MDCLL  rectangles  and  vlas  (Out_H_Segment 
Module  7. 3. 3.1).  Both  modules  are  performed  recursively  until  every 
wire  In  the  trinary  w1re_statement  structure  tree  has  been  processed. 
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4. 9. 3. 3.1  Out  W  Comment  (Module  7.3.3. 1). 

The  Out_M_Conment  module  simply  outputs  the  segments  of  the  wire 
out  to  the  disk  In  the  form  of  a  CIF  comnent  line.  This  Is  performed 
recursively  until  every  segment  Is  output.  It  accepts  the  previous 
segments  width  and  layer  as  Input  along  with  a  pointer  to  the  next 
segment  to  be  processed  and  the  pointer  to  the  output  disk  file. 

4. 9. 3. 3. 2  Out  W  Segment  (Module  7.3.3. 2). 

The  Out_W_Segment  module  Is  the  most  complicated  of  all  the  output 
modules  since  It  determines  the  location  and  size  of  the  rectangles 
making  up  a  wire,  and  the  vlas  allowing  any  necessary  layer  changes  In 
the  wire.  It  accepts  the  previous  segment's  width  and  layer,  as  well  as 
the  X  and  y  location  for  the  start  of  this  segment,  the  pointer  to  the 
next  wire  segment,  and  the  pointer  to  the  output  file.  It  first  outputs 
the  comment  describing  the  segment.  Next,  It  determines  the  proper 
rectangle  parameters  to  describe  this  segment  and  places  them  In  the 
rectangle  structure  by  layer  (Rect_Tree  Module  1.3. 2.1).  Then,  If  there 
Is  a  next  segment,  the  x  and  y  location  Is  adjusted  to  the  opposite  end 
of  the  present  segment,  and  If  the  next  segment  layer  Is  different  then 
the  current  layer,  the  proper  x  and  y  location  of  the  needed  via  Is 
stored  In  the  proper  via  structure  based  on  layer  (V1a_Tree  Module 
1.3. 4.1).  Finally,  the  starting  x  and  y  location  for  the  next  segment 
has  to  be  determined  based  on  the  direction  of  movement  to  ensure  all 


corners  are  filled  In.  This  module  Is  called  recursively  until  every 
segment  of  the  wire  Is  processed. 


4. 9. 3. 4  Out  Via  Tree  (Module  7,3.41. 

The  module  Out_Via_Tree  outputs  one  layer  of  the  via  definition  at 
a  time.  It  accepts  the  pointer  to  the  next  via,  the  via  size,  and  the 
pointer  to  the  output  file  as  Input  parameters.  The  via  x  and  y  loca¬ 
tion  Is  output  along  with  the  size  of  the  via  based  on  the  size  given  by 
the  Input.  If  needed,  the  bounds  of  the  cell  are  adjusted  accordingly. 
The  via  trinary  tree  structure  Is  recursively  walked  ensuring  all  vlas 
are  output. 

4. 9. 3. 5  Out  Call  Tree  (Module  7.3.51. 

The  Out_Call_Tree  module  accepts  the  pointer  to  the  next  call 
statement  and  the  pointer  to  the  output  file  as  Input  parameters.  It 
then  outputs  a  GIF  comment  line  describing  the  call  statement  and  then 
the  GIF  call  statement  Itself  (Out_G_Statefflent  Module  7.3.5. 1).  It  then 
outputs  the  port  names  associated  with  the  call  (Out_P_Names  Module 
7. 3. 5. 2).  This  Is  performed  recursively  until  all  the  call  statements 
have  been  processed. 

4. 9. 3. 5.1  Out  G  Statement  (Module  7.3.5.11. 

Out_G_Statement  outputs  the  call  statements  to  the  output  file 
designated  by  the  Input  parameter  "fp”.  It  also  accepts  as  Input  the 
GIF  number  of  the  cell,  translational  co-ordinates,  mirroring  Instruc¬ 
tions.  rotational  position  of  the  x-axIs,  and  the  bounds  of  the  called 
cell.  This  module  outputs  the  call  statement  In  a  set  order:  first  the 
mirroring  Is  performed,  then  any  necessary  rotation,  followed  by  the 
translation.  Based  on  the  mirroring  and  rotational  Instructions  the 
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ffnal  translational  position  may  or  may  not  need  to  be  adjusted.  The 
module  ensures  that  after  the  mirroring  and  rotating,  the  new  lower  left 
corner  of  the  cell  is  placed  at  the  translational  location  specified  by 
the  user.  Finally,  the  bounds  of  the  parent  cell  are  adjusted  as  needed. 

4. 9. 3. 5. 2  Out  P  Names  (Module  7.3.5.21. 

The  Out_P_Names  module  accepts  the  pointer  to  the  next  named_ports 
location  and  the  pointer  to  the  output  file  as  input  parameters.  While 
there  are  more  port  names  defined,  this  module  outputs  the  portname,  in 
the  form  of  a  GIF  comment,  to  the  file. 
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4. 9. 3. 6  Out  Iter  Tree  (Module  7.3.6). 

The  Out_Iter_Tree  module  accepts  the  pointer  to  the  next  iterate 
statement  and  the  pointer  to  the  output  file  as  Input  parameters.  It 
then  outputs  a  GIF  comment  line  describing  the  Iterate  statement  and 
then  the  number  of  GIF  call  statements  needed  to  describe  this  Iteration 
(Out_G_Statement  Module  7. 3. 5.1).  This  module  then  outputs  the  port 
names  associated  with  the  iteration  (Out_P_Names  Module  7. 3. 5. 2).  This 
is  performed  recursively  to  process  all  the  iterate  statements. 

4.9.4  Footer  Out  File  (Module  7.4). 

Finally,  the  GIF  end  of  cell  information  Is  output  to  the  file 
using  the  Footer_0ut_F1 le  module.  This  module  accepts  the  cellname,  GIF 
number,  and  pointer  to  the  output  file  as  Input  parameters.  It  Includes 
a  GIF  comment  line  describing  the  bounds  of  the  cell,  the  GIF  definition 
finished  marker  (DF),  a  GIF  call  statement  Invoking  the  cell,  and  the 
GIF  end  of  file  marker  "E". 
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This  analysis  examines  the  degree  to  which  the  requirements  stated 
In  Chapter  2  were  met.  The  requirements  to  be  checked  are  the  overall 
requirements,  the  Implementation  requirements,  the  requirements  of  the 


system  and  each  function  In  the  system,  and  finally  the  performance 
requirements. 

5.1  Overal 1 . 

The  basic  requirement  of  the  system  is  to  be  easy  to  use  by  the 
chip  designer.  This  requirement  has  been  achieved  by  the  segmentation 
of  the  programs  based  on  function,  and  the  use  of  menus.  The  use  of 
independent  programs  and  libraries  of  routines,  along  with  the  Implemen¬ 
tation  of  a  standard  header  for  use  throughout  the  system,  and  the 
Inclusion  of  the  hierarchy  charts  as  part  of  the  code  has  made  the 
system  easily  maintainable  as  well. 

The  next  requirement  examined  Is  the  compatibility  with  CIF  and  CLL 
files.  The  output  files  produced  by  the  MOCLL  system  are  totally  CIF 
compatible;  however,  the  MOCLL  system  cannot  read  standard  CIF  files  nor 
files  produced  by  CLL.  This  Is  caused  by  the  fact  that  MOCLL  reads 
comment  lines  to  determine  If  the  CIF  statements  that  follow  are  MOCLL 
rectangles,  wires,  or  vias.  To  solve  this  problem,  the  Get_Ce11  module 
(2.1)  would  have  to  be  modified  to  Include  the  ability  to  read  the  CIF 
layer,  box,  and  call  statements.  Also,  extra  pointers  would  need  to  be 
included  to  allow  for  boxes  (rectangles)  In  layers  which  form  vias  (e.g. 
glass)  and  the  necessary  software  to  manipulate  these  boxes  throughout 


the  system.  HoMever,  implementing  this  would  negate  any  savings  in 
internal  memory  space  for  the  cell  and  design  time  afforded  by  the  HDCLL 
wire,  via,  and  iterate  statements  which  are  much  easier  to  use  than  the 
CIF  box  and  call  statement. 

Table  5.1  shows  the  CIF  commands  implemented. 


I  CIF  Command 


I  Required  I  Implemented  I 


Polygon  with  path 
Box  with  length,  width, 
center,  and  direction 
Round  Flash 

Mire  with  width  and  path 
Layer  specification 
Start  symbol  definition 
Finish  symbol  definition 
Delete  symbol  definition 

Call  symbol  I  X  |  X 

Comments  j  X  )  2 

End  marker  1X1  X 

1.  A  wire  statement  similar  to  CLL  was  implemented  I 
and  is  translated  into  CIF  box  statements  on  output. I 

2.  Comments  are  included  in  the  CIF  produced,  but  I 

the  user  cannot  enter  comment  lines.  I 


TABLE  5.1  CIF  commands  implemented 


Another  concern  for  the  experienced  circuit  designer  is  that  the 
MDCLL  system  presently  only  accepts  integers  when  numbers  are  needed. 
This  limitation  of  using  only  Integers  causes  the  MDCLL  lambda  unit  to 
be  half  the  size  of  the  common  CLL  and  CIF  lambda  unit  (1  common  CIF 
lambda  unit  =  2  MDCLL  lambda  units),  which  results  in  a  different  sca¬ 
ling  factor  in  the  MDCLL  system.  This  use  of  integers  is  simpler  for 


both  the  program  and  the  user  since  there  are  no  fractions  to  contend 
with.  Another  problem  with  using  only  integers  is  in  the  conversion  to 
GIF  box  statements  which  require  the  center  of  the  box  as  reference.  To 
perform  this  conversion  the  length  and  width  of  the  box  must  be  Inte¬ 
grally  divided  in  half  (difficult  to  perform  with  odd  integers)  and 
therefore  this  is  another  reason  for  doubling  the  normal  number  of 
lambdas  on  a  grid.  If  the  use  of  non-integer  values  was  essential,  the 
internal  machine  representation  of  the  values  could  remain  as  integers 
and  simply  convert  as  needed  for  input  and  output. 

5.2  Implementation. 

The  HOCLL  system  was  successfully  designed  and  implemented  on  a  CP/H 
operating  system-based  microcomputer  with  64K  of  main  memory.  The 
largest  executable  file  in  the  system  (see  Table  5.2  for  the  sires  of 
the  executable  files)  is  26K  which,  leaving  16K  for  the  operating  system 


Program 


Assembly  language 
File  Size  (Kbytes) 


MDCLL  1 

16  K 

1  5163 

/ 

6 

K 

-| 

CREATE  1 

58  K 

1  24481 

/ 

24 

K 

DPM  1 

98  K 

1  23255 

/ 

24 

K 

MODIFY  1 

112  K 

1  26580 

/ 

26 

K 

INTER  1 

10  K 

1  3683 

/ 

4 

K 

PRIPLO  1 

16  K 

1  4601 

/ 

5 

K 

FINALIZE  1 

44  K 

1  10627 

/ 

12 

K 

SAVECELL  1 

70  K 

1  16099 

/ 

16 

K 

Total  disk  space  needed 

117 

K 

Executable  File 
(bytes/K  bytes) 


Table  5.2  MOCLL  Disk  Space  Usage 


and  2K  as  spare,  leaves  an  Internal  storage  area  of  20K  for  any  one 
MDCLL  cell  (see  Paragraph  5.4  for  sample  cells).  As  shown  in  Table  5.2, 
the  total  disk  space  needed  for  the  executable  HDCLL  files  Is  117K. 

(The  assembly  language  size  of  each  program  Is  also  given  to  show  the 
amount  of  disk  space  needed  for  the  compilation  process.)  This  117K 
easily  fits  onto  one  diskette  and  leaves  room  for  cells  on  the  diskette 
or  the  system  allows  the  use  of  other  disk  drives  for  cell  file  storage. 

There  are  two  compiler  semi -unique  features  utilized  by  the  MDCLL 
system.  One  Is  the  use  of  the  "exec”  command  which  allows  one  program 
to  execute  another  without  returning  to  the  first.  This  function  is 
similar  to  the  "system"  command  described  In  Kernighan  and  Ritchie, 
however,  the  "system"  command  returns  control  to  the  calling  program. 
This  Is  semi-unique  since  most  C  compilers  support  this  type  of  func¬ 
tion,  although  the  actual  command  line  may  be  different.  The  second 
semi -unique  compiler  function  used  Is  the  "Oifneed"  and  "#endif"  state¬ 
ment  pair  used  In  the  module  libraries.  This  pair  of  statements  allows 
the  Inclusion  of  an  entire  library  of  modules  while  only  the  modules 
needed  by  the  program  are  actually  Included  during  compilation.  Most  C 
compilers  have  a  function  similar  to  this,  although  once  again,  the 
actual  command  lines  may  vary. 

5.3  System. 

The  MDCLL  system  Is  capable  of  allowing  the  user  to  create  new 
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cells  In  CIF,  delete,  place,  or  move  cells  In  relation  to  other  cells, 
modify  cells.  Interconnect  cells,  and  print  CIF  files.  The  programs 
Implementing  these  functions  are  shown  In  Table  5.3  along  with  the 
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needed  libraries  of  modules  In  the  MDCLL  system.  (The  functions  are 
described  In  the  following  paragraphs  and  the  hierarchy/structure  charts 
and  the  code  are  Included  In  Appendices  A  and  B.)  The  system  does  not 
allow  the  Input  of  a  cell  from  a  library  of  cells,  although  the  cell 
needed  could  be  copied  Into  a  separate  file  and  then  used  by  way  of  the 
call  or  Iterate  HDCLL  statements. 


1  File 

size 

1 

Included  files  I 

1  MDCLL. H 

6 

K 

1 

TPRINTF.C.  EXEC.C  I 

1  MDCLL. C 

10 

K 

1 

MDCLL. H.  STDLIB.C  I 

1  CREATE.C 

8 

K 

1 

HDCLL. H.  CRE8LIB.LIB.  STDLIB.C  I 

1  CRE8LIB.LIB 

44 

K 

1 

none  1 

1  DPM.C 

10 

K 

1 

1 

MDCLL. H.  DPMLIB.LIB,  CRE8LIB.L1B,  | 
SAVELIB.LIB,  STDLIB.C  I 

1  DPMLIB.LIB 

48 

K 

1 

none  1 

1  MODIFY. C 

8 

K 

1 

I 

MDCLL. H.  MODLIB.LIB.  DPMLIB.LIB.  I 
CRE81I6.LIB.  STDLIB.C  I 

1  MODLIB.LIB 

22 

K 

1 

none  I 

1  INTER. C 

2 

K 

1 

MDCLL. H  1 

I  PRIPLO.C 

4 

K 

1 

1 

MDCLL. H,  DPMLIB.LIB,  CRE8LIB.LIB,  I 
SAVELIB.LIB,  STDLIB.LIB  I 

1  FINALIZE. C 

8 

K 

1 

1 

1 

MDCLL. H.  FINALLIB.LIB,  DPMLIB.LIB, I 
MODLIB.LIB.  CRE8LIB.LIB,  I 

SAVELIB.LIB.  STDLIB.C  I 

1  FINALLIB.LIB 

8 

K 

1 

none  I 

1  SAVECELL. C 

4 

K 

1 

1 

MDCLL. H.  SAVELIB.LIB.  CRE8LIB.LIB. I 
STDLIB.C  1 

1  SAVELIB.LIB 

34 

K 

1 

none  I 

1  TPRINTF.C 

4 

K 

1 

This  Is  a  system  file  I 

1  EXEC.C 

6 

K 

1 

This  Is  a  system  file  1 

1  STDLIB.C 

1 

10 

K 

1 

This  Is  a  system  library  file  I 

1 

1  Total  disk  space  = 

236 

K 

Table  5.3  Programs  and  libraries  used  In  the  MDCLL  system 
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5.3.1  Create  Function. 

The  HDCLL  system  Is  capable  of  creating  a  new  CIF  file  based  on 
user  Inputs  by  use  of  the  CREATE  and  SAVECELL  programs.  The  CREATE 
program  allows  the  user  to  define  rectangles,  wires,  vlas,  and  Intercon¬ 
nection  ports.  These  definitions  are  then  converted  to  CIF  and  stored 
to  disk  by  the  SAVECELL  program.  The  CIF  polygon,  round  flash,  and  CIF 
wire  statement  were  not  Implemented  In  this  version  of  HDCLL  as  shown  In 
Table  5.1.  However,  a  wire  statement  and  via  similar  to  the  CLL  state¬ 
ments  are  supported.  The  naming  of  wires,  vlas,  and  rectangles  Is  not 
supported  In  this  version.  This  can  easily  be  Implemented  by  adding 
storage  locations  In  the  structures  defining  these  statements,  allowing 
the  user  to  Input  and  modify  the  Information,  and  providing  for  the 
output  of  this  Information.  When  the  user  Is  finished  creating  a  cell 
the  cell  Is  converted  to  CIF  and  saved  to  disk  by  the  SAVECELL  program. 

5.3.2  Delete.  Place,  or  Hove  Function. 

The  HDCLL  system  allows  the  user  to  delete,  place,  or  move  a  cell 
In  the  hierarchy  of  cells  through  the  use  of  the  OPH  and  SAVECELL 
programs.  Included  Is  the  ability  to  Iterate  cells  In  the  same  manner 
as  in  the  CLL  language.  To  keep  the  functions  segmented  Into  programs, 
the  DPH  program  not  only  Includes  the  creation  of  calls  and  Iterations 
but  also  provides  the  user  with  the  capability  to  modify  or  delete  calls 
and  Iterations.  The  requirement  of  warning  the  user  If  cells  overlap 
has  not  been  Implemented  In  this  version  of  HDCLL.  When  the  user  Is 
finished,  the  new  or  modified  cell  Is  converted  to  CIF  and  stored  to 
disk  by  the  SAVECELL  program. 


5.3.3  Modify  Function. 

The  MDCLL  system  allows  the  user  to  modify  any  cell  In  the  hierar¬ 
chy  of  cells  by  use  of  the  MODIFY  and  SAVECELL  programs.  The  MODIFY 
program  reads  the  cell  to  be  modified  into  main  memory  and.  through  the 
use  of  menus,  allows  the  user  to  modify  any  previous  entries  and  to  add 
new  Information.  Upon  completion,  the  new  cell  Is  then  converted  to  CIF 
and  saved  to  disk  by  the  SAVECELL  program.  The  requirement  to  Inform 
the  user  If  the  cell  has  changed  In  size  has  not  been  Implemented,  but 
could  easily  be  accomplished  by  storing  the  previous  cell  size  (or 
bounds)  and  comparing  this  size  with  the  new  cell  size. 


5.3.4  Interconnect  Function. 

The  Interconnect  function  has  not  been  Implemented  In  this  version 
of  MDCLL.  Upon  entrance  to  the  Interconnect  program  (INTER)  the  user  Is 
Informed  that  cell  Interconnection  must  be  performed  by  use  of  the 
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modify  function  and  It  Is  suggested  that  the  wire  statement  be  used. 
Future  versions  of  MDCLL  should  allow  the  Interconnection  of  cells  via 


the  use  of  the  predefined  port  names  as  the  locations  for  wire  starts 
and  stops  and  eventually  even  an  automatic  routing  routine. 


5.3.5  Print/Plot  Function. 

The  MDCLL  system  has  the  requirement  to  be  able  to  print  the  CIF 
files  of  the  cells  and  plot  not  only  the  bounding  box  diagram  of  any 
cell  In  the  hierarchy  showing  the  location  of  cells  within  the  cell 
being  plotted,  but  also  the  entire  CIF  layout  by  execution  of  the 
MCIFPLOT  program.  The  ability  to  print  files  to  the  terminal  has  been 
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Implemented  by  use  of  the  PRIPLO  program  but  neither  the  plotting 
routine,  nor  the  direct  interface  with  MCIFPLOT,  have  been  Implemented 
In  this  version  of  HDCLL.  To  obtain  a  plot,  the  user  must  learn  to  use 
the  MCIFPLOT  program. 

5.4  Performance. 

The  main  performance  criteria  of  the  HOCLL  system  Is  to  be  an  easy 
to  use  system.  This  translates  to  menus  that  are  self-explanatory,  so 
the  user  doesn't  get  frustrated,  and  response  times  that  keep  the  user 
from  becoming  bored  waiting  for  the  system.  The  HDCLL  system  provides 
both  of  these.  The  menus  are  easily  understood  and  provide  simple  error 
messages  prompting  the  user  to  Input  correct  data.  The  response  time  of 
the  system  Is  very  good.  The  system  responds  Immediately  to  the  user  on 
all  commands  except  the  following.  Each  time  a  different  program  In  the 
system  Is  executed  a  noticeable  delay  Is  caused  by  the  reading  of  the 
program  Into  memory.  This  delay  cannot  be  alleviated.  Another  delay  Is 
noticed  when  a  cell  is  Input  from  disk  Into  main  memory  or  a  cell  Is 
output  to  disk  from  main  memory  (the  larger  the  cell,  the  longer  the 
delay).  To  aid  in  keeping  the  user  from  becoming  bored  at  this  stage  In 
the  system,  messages  are  printed  to  the  screen  upon  the  start  of  input¬ 
ting  or  outputting  the  next  set  of  CIF  statements  (e.g.  rectangles  and 
Vlas).  The  last  area  where  the  user  may  become  concerned  Is  during  the 
FINALIZE  program  which  brings  several  CIF  files  together  Into  one  file. 
Here,  the  files  are  printed  to  the  screen  as  they  are  being  transferred 
to  the  one  file  to  let  the  user  know  the  system  Is  working. 

The  only  other  performance  criteria  is  the  size  of  cell  which  can 


be  manipulated  by  the  MOCLL  system  and  the  size  of  circuit  which  can  be 
accommodated.  As  stated  In  the  requirements  (Paragraph  2.4),  the  memory 
capacity  of  the  disk  being  used  Is  the  only  limiting  factor  on  the  size 
of  a  final  circuit.  The  size  of  any  given  cell,  though.  Is  limited  by 
the  amount  of  available  memory  In  the  machine,  since  the  cell  Is  stored 
Internally  while  being  worked  on.  This  usable  memory  Is  limited  to  the 
available  memory  after  the  largest  program  In  the  HDCLL  system  Is  resi¬ 
dent  along  with  the  operating  system.  The  operating  system  occupies  16K 
of  memory  and,  as  shown  In  Table  5.2,  the  largest  program  In  the  HDCLL 
system  occupies  26K  of  memory.  This  leaves  20K  of  memory  (with  2K 
spare)  for  storing  any  given  cell.  The  problem  now  Is  In  determining 
what  can  actually  be  stored  In  20K  of  memory  In  terms  of  a  cell  design. 
Six  cells  were  encoded  In  GIF  using  the  HDCLL  system  to  establish  the 
usefulness  of  the  system.  The  files  produced  by  HDCLL  for  the  six  cells 
are  Included  in  Appendix  C  along  with  an  HCIFPLOT  run  on  each  cell.  The 
data  resulting  from  these  cells  Is  provided  In  Table  5.4.  Since  the 
rectangle  statement  provides  no  great  advantage  over  using  GIF,  the 
HDCLL  wire  statement  was  used  to  Implement  these  cells.  The  six  cells 
Implemented  are  a  simple  six  transistor  memory  cell,  a  mask  cell  for  use 
In  a  content  addressable  memory  (CAH),  a  full  subtractor,  a  cell  called 
"BINBOUT"  for  use  In  a  CAH,  which  combines  the  mask,  memory  and 
subtractor  cells,  a  cell  called  "HEH2"  which  simply  calls  "BINBOUT" 
twice,  and  a  cell  called  HEH8  which  Iterates  eight  memory  cells.  The 
BINBOUT,  HEH2,  and  HEH8  cells  were  each  FINALIZEd  to  produce  the  plots 
In  Appendix  C.  The  statistics  shown  In  Table  5.4  are  based  on  these 
FINALIZEd  files.  Another  cell,  CAHHEH  (the  entire  memory  array  of  a  CAH 
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1.  Number  of  transistors  contained  in  cell 

2.  Number  of  MDCLL  wire  statements  /  calls  and  iterates  used 

3.  Amount  of  internal  memory  used  in  bytes 

4.  Percentage  of  memory  used  to  memory  available 

5.  Number  of  GIF  comment  statements  in  file 

6.  Number  of  GIF  Layer  statements  in  file 

7.  Number  of  GIF  Box  statements  /  call  statements  in  file 

8.  Amount  of  disk  space  used  in  bytes 


Table  5.4  Sample  HOGLL  cell  files 


chip,  128x16  memory  cells)  was  entered.  The  GAMMEM  cell  plot  is  not 
included  in  Appendix  G  since  a  cell  of  this  complexity  cannot  be  handled 
by  MGIFPLOT  producing  a  readable  plot  on  one  page.  The  GAMMEM  file  is 
not  reproduced  since  the  file  is  identical  to  the  MEM8  file  except  for 
2048  GIF  call  statements  to  the  BINBOUT  cell  instead  of  eight.  It  took 
less  than  two  minutes  for  the  FINALIZE  program  to  complete  the  task  of 
finalizing  the  GAMMEM  and  the  FINAL.GIF  file  for  this  cell  occupies  24K 
of  disk  space.  As  shown  from  the  data  in  Table  5.4  the  test  cells  used 
less  than  ten  percent  of  the  available  memory  and  still  provides  for  a 
complex  circuit  through  the  use  of  intermediate  cells  which  call  or 
iterate  lower  level  cells. 
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6.  Recommendations  and  Conclusions 
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In  this  chapter  the  recommendations  for  the  improvement  of  the 
HDCLL  system  are  discussed.  Also  included  are  the  recommendations  for 
future  developments  of  computer  aided  design  tools  in  the  microcomputer 
environment.  Finally,  the  conclusions  reached,  based  on  the  work 
performed  on  this  thesis,  are  discussed. 

The  following  recommendations  are  suggested  to  improve  the 
usefulness  of  the  HDCLL  system: 

1.  The  most  Important  Improvement  needed  to  the  HDCLL  system  is  to 
allow  the  use  of  normal  CIF  units  (including  half  lambda  measurements). 
The  system  must  allow  the  user  to  enter  either  integers  or  floating 
point  numbers  and  then  either  store  these  as  integers  after  a  conversion 
(multiply  by  four  if  the  system  is  limited  to  half  lambda  measurements) 
or  simply  change  all  internal  storage  to  floating  point.  This  second 
method  would  use  much  more  memory  space  and  is  therefore  not  suggested. 

2.  Changes  need  to  be  made  to  the  FINALIZE  and  DPH  programs  to 
ensure  that  if  a  standard  CIF  file  has  no  bounds  statement,  it  can  still 
be  instanciated  (called  or  iterated)  by  an  HDCLL  cell.  Presently,  the 
system  errors  out  if  the  bounds  statement  cannot  be  found.  Due  to  this 
capability  of  instanciating  existing  CIF  files,  the  HDCLL  system  should 
not  be  modified  to  allow  the  reading  and  modification  of  non-HOCLL 
created  files.  This  is  suggested  since  the  extra  code  needed  to  imple¬ 
ment  the  reading  and  modification  of  non-HDCLL  created  CIF  files  would 
unnecessarily  increase  the  size  and  complexity  of  the  HDCLL  programs. 
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3.  A  desired  Improvement  to  the  system  would  be  to  allow  the 
Instanclatlon  of  a  cell  whose  description  Is  contained  In  a  library  of 
cells.  To  do  this  the  OPH  program  would  have  to  be  modified  to  ask  the 
user  the  name  of  the  library  and  then  ensure  the  cell  was  contained  In 
the  library  and  obtain  the  bounds  statement  from  the  definition  of  the 
cell.  Also,  the  FINALIZE  program  would  need  to  be  modified  to  allow  the 
searching  of  libraries  for  the  needed  cells. 

4.  In  using  the  HOOIFY  program,  the  user  should  be  Informed  of  a 
change  In  the  cell  bounds.  This  will  allow  the  user  to  ensure  surround¬ 
ing  cells  are  not  affected  by  the  modification  or.  If  needed,  can  be 
adjusted  accordingly.  Since  the  HDCLL  call  and  Iterate  statements 
Include  the  bounds  of  the  cell  being  Instantiated  the  FINALIZE  program 
should  check  these  bounds  against  the  actual  bounds  stored  with  the  cell 
definition  to  ensure  they  match.  If  the  bounds  don't  match  the  user 
should  be  provided  with  a  warning  message. 

5.  The  entire  INTER  program  needs  to  be  designed  and  Implemented. 
This  should  Include  the  Interconnection  of  cells  via  the  use  of  the 
predefined  Interconnection  ports.  It  would  also  be  desirable  to  Include 
an  automatic  router.  This  ability  of  using  the  Interconnection  ports 
should  also  be  Included  In  the  CREATE  and  HODIFY  programs  so  the  user 
can  give  the  name  of  the  location  to  be  connected  Instead  of  the  actual 
coordinates. 

6.  The  PRIPLO  program  should  be  completed.  This  Includes  an 
automatic  running  of  the  HCIFPLOT  program  and  the  capability  to  plot  the 
bounding  box  diagram  of  any  cell  in  the  hierarchy  of  cells.  It  would  be 
desirable  to  Implement  the  bounding  box  plotting  function  using  only  the 
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standard  ASCII  character  set  to  ensure  compatablllty  with  all  printers 
and  plotters. 

For  the  future,  the  HDCLL  system  should  be  enhanced,  as  described 
above.  Also,  the  following  Items  should  be  Included  In  the  set  of 
computer  aided  design  tools  for  the  microcomputer  environment. 

1.  A  program  to  perform  design  rule  checking  on  an  Input  CIF  file 
similar  to  the  program  ORC  presently  hosted  on  the  AFIT  UMIX/VAX. 

2.  A  circuit  extractor  program  should  be  Implemented  to  extract 
the  circuit  definition  based  on  an  Input  CIF  file  similar  to  the  MEXTRA 
program  presently  hosted  on  the  AFIT  UNIX/VAX. 

3.  A  circuit  simulator  program  should  be  Implemented  to  perform 
switch  level  simulations  on  the  circuit  described  by  the  file  output  by 
the  extractor  program  described  above. 

The  MOCLL  system  successfully  shows  that  a  high  level  layout 
language  can  be  Implemented  on  a  microcomputer  with  limited  memory  space 
and  still  be  user  friendly.  Initially,  It  was  thought  the  cell  being 
worked  on  would  have  to  be  stored  on  disk  Instead  of  main  memory  due  to 
the  program  size.  This  would  have  caused  noticeable  delays  to  the  user 
while  working  on  a  cell.  As  shown  In  Paragraph  5.4,  the  size  of  the 
cell  which  can  be  Implemented  using  the  HDCLL  system  Is  quite  adequate. 
This  efficient  use  of  memory  Is  obtained  by  the  separation  of  the 
functions  of  the  HDCLL  system  into  several  Independent  programs. 
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Hierarchy/Structure  Charts 


This  appendix  presents  the  hierarchy  and  structure  charts  for  the 
HDCLL  system.  They  are  arranged  by  program  and  module  number.  The 
hierarchy  chart  for  each  program  Is  presented  first  followed  by  the 
structure  charts  for  the  modules  defined  In  that  program.  An  asterisk 
associated  with  a  module  In  any  chart  signifies  the  module  Is  defined 
under  the  given  module  number.  An  “r”  associated  with  any  module 
signifies  the  given  module  Is  recursive. 
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1 - e.l.lr  Primary  Calls 

k 

k 

1 

1  1 - 6.1.T.lr  Call  Names 

k 

k 

1 

1 

k 

k 

1 

1 - 6.1.2r  Iter  Calls 

k 

k 

1 

1  1 - 6. 1.1.1*  Call  Names 

k 

k 

1 

1 

k 

k 

1 

1 - 6.1.3  Process  Call 

k 

k 

1 

1  1 - 1.2.T*  Get  Option 

k 

k 

1 

1  1 - 2.1.1*  In  File 

k 

k 

1 

1  1 - 7.2.1*  Out  File 

k 

k 

1 

1  1 - 6. 1.1.1*  Call  Names 

k 

k 

1 

1  1 - 7.1*  Oet  Cifnum 

k 

k 

1 

1 

k 

k 

1 

1 - 2.1.1*  In  File 

k 

k 

1 

1 

k 

k 

1 

1 - 7.2.1*  0ut_F11e 

k 

k 

1 

k 

k 

—  1.2.1*  Get_0pt1on 

k 

k 

1 

k 

k 

---  0.0*  MOCLL  Main 
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k 
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SAVECELL  Program  Hierarchy; 


7.0  SAVECELL  Main 

I 

I - 7.1  Oet_Cifnuffl 

I 

I - 7.2  Header_Out  File 

I  I - 7.2.1  Out_File 

I 

I - 7.3  0ut_Ce11_Layout 

I  I 

I  I - 7.2.1*  Out_File 

I  1 

I  I - 7.3.1r  Out_Port_Tree 

I  I  I - 7.2.1*  Out_File 

I  I 

I  I - 7.3.2r  Out_Rect  Tree 

I  I  I - 7.2.1*  Out_File 

I  I 

I  I - 7.3.3r  Out  Mire  Tree 

1  I  I - 7.2.1*  Out_File 

1  I  I - 7.3.3. Ir  Out  W  Comment 

(  (  I - 7.2.1*  Out_Ff?e 

I  I  1 - 7.3.3.2r  Out  W  Segment 

I  I  I - 7.2.1*  Out_Fi1e 

I  I  I - 1.3.2. 1*  Rect  Tree 

I  I  I - 1.3.4. 1*  Via_Tree 

I  1 

I  I - 7.3.4r  Out_Via_Tree 

I  I  1 - 7.2.1*  Out_File 

I  I 

I  I - 7.3.5r  Out_Call_Tree 

I  1  I - 7.2.1*  Out_File 

1  1  I - 7.3.5. 1  Out_C  Statement 

1  I  I  I -  772.1*  Out_File 

1  1  I - 7. 3. 5. 2  Out_P_Names 

I  I  I - 7.2.1*  Out_Fi1e 

I  I 

I  I - 7.3.6r  Out_Iter  Tree 

I  I - 7.2.1*  Out_File 

1  1 - 7.3.5. 1*  Out_C_Statement 

I  ( -  7. 3. 5. 2*  Out_P_Mames 

I 

I - 7.4  Footer_Out_Fi le 

I  I - 7.2.1*  Out_File 

I 

1 - 0.0*  MDCLL  Main 
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I  SAVECELL 
I  nain 


I  Out_Ccll 
I  Layout 


(  Out_Port 
I  Tree 


I  Out_Uir« 
1  Tree 


CoMtnt 


I  Se9aent 
I  7.3.3.2 


>no  I 


I  Oul.Coll 
I  Tre* 


his  aodule  defined  under  the  9iven  aodule  nuaber 
his  aodule  is  recursive 
output  string,  seporotor,  fp 

cifnua,  t_x,  t_v,  b_x,  b_v.  r_x,  x_ain,  y_ain,  x_box,  y_aox,  fp 
c_ports,  fp 


I  Out J ter 
I  Tree 
1  7.3.6 


defined  under  the  given  eodule  nuaber 

is  recursive 

ing,  separator,  fp 
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r  *1 

/*  STANDARD  HEADER  FOR  USE  IN  THE  MDCLL  SYSTEM  */ 

/*  */ 

liciiicificic'kiciticitieiciriciticic'kie'k'kic’kic'kic'iricititicic'kitit'k'k'k'kiticltit'kit'k'k'kltit'kit'kific'kicic'kicit'k'k  j 


I'k'ititit'kit'it'kicitit'k’kitieit'kit'kititit'kititit'kitititititii'lcitit'k'kitititicit'kit'kicitit'kitititit'k'k'kitit'iiititit'k  J 

/*  */ 
/*  The  file  tprintf.c  is  included  to  allow  output  to  the  user  */ 
/*  by  way  of  the  C  language  statement  "printf"  */ 

/*  V 

#include  "tprintf.c"  /**/ 

r  *! 

y  ★★**************#**llf**»*^lr**#*ilr***llr****i(lf***************^lf***ilf*****  J 


I'k'k'kit-kit'kit-kitit'kitit'k'k'k'kit'kitit'kit'k'k'k'kititit'kic'k-k'k'k-kicic'kicititititititit-kic'kidacicickitickitick  j 

/*  */ 

/*  The  file  exec.c  is  included  to  permit  the  execution  of  */ 

/*  one  program  from  the  interior  of  another  */ 

/*  */ 

^include  "exec.c"  /**/ 

/*  */ 

^ ***★******★★****************★*****★★*******★*★**★★★***»*★★***»** ! 


/*  */ 

/*  Following  are  the  global  constants  used  in  the  MDCLL  system  *! 
/*  The  first  five  are  here  since  they  are  used  in  many  of  the  */ 
/*  programs  in  the  system;  the  rest  are  in  the  header  to  */ 
/*  highlight  them  since  they  will  most  likely  need  changing.  */ 
/*  */ 

^define  FILE  int  /**/ 

iidefine  EOF  -1  /**/ 

#define  TRUE  1  /**/ 

iidefine  FALSE  0  /**/ 

iidefine  NULL  0  /**/ 

lidefine  SCALE_A  "50"  /**/ 

(idefine  SCALE_B  "1"  1**1 

^define  M_VIA_SIZE  8  1**1 

iidefine  M2_VIA_SIZE  8  1**1 

^define  0_VIA  SIZE  8  1**1 

Ndefine  C_VIA_SIZE  4  1**1 

^define  V_VIA_SIZE  4  1**1 

iidefine  P_VIA_SIZE  10  1**1 

Ndefine  AVAIL_SPACE  20480  1**1 

/*  *1 


I*  */ 

I*  FolloMlng  are  the  global  variables  and  initial  values  */ 

I*  */ 

:har  layer  =  'P' ;  /**/ 

:har  *seg_ptr  =  MULL;  /**/ 

:har  *c_port_ptr  =  MULL;  /**/ 

:har  *1  ca11_ptr  =  MULL;  /**/ 

int  inin_x_b  =  9999;  /**/ 

int  in1n_y_b  =  9999;  /**/ 

int  max_x_b  =  -9999;  /**/ 

int  max_y_b  =  -9999;  /**/ 

int  space_used  »  0;  /**/ 

f*  ~  */ 

fiticifitititiricititicieitititititititic’kititirititigiritititiiifitit'kiticfc'kiticicitickiciticfc'kir'kitick'kiticK'kick'k  i 


Sts::.* 


m.  ^ 


/*  */ 

/*  Following  are  the  Structures  for  storing  GIF  in  memory  */ 

/*  */ 

^**4rVr**A*4r****«'*VrVr4r**Vrl^*4r*****VrA**Vr4r**4t*4t***:l^*Vt****4t4t*****Vr*W:**4rVr  j 


1**1 

1**1 

struct 

inter  ports 

1**1 

{ 

1**1 

char  port_name  (15) 

1**1 

port  layer; 

1**1 

int  x_1oc,  y_loc; 

1**1 

struct  inter  ports  *n 

1**1 

1**1 

*port_ptr  =  MULL; 

1**1 

1**1 

struct 

rectangle 

1**1 

( 

1**1 

int  height. 

1**1 

length. 

1**1 

xjocation. 

1**1 

y_location; 

1**1 

struct  rectangle 

1**1 

*1ess_than_xl 

1**1 

*equals  X. 

1**1 

*greater  than 

1**1 

} 

1**1 

*f_rect,  *s_rect,  *d_r 

1**1 

*w_f_rect,  *w_s  rect. 

N.  / 

• 


r* 

V  %• 
•«* 


\'A'' 

struct 

via 

r.  - 

1**1 

{ 

1**1 

int  v_x_locatlon. 

1**1 

v_y_1ocation; 

1**1 

struct  via 

1**1 

*v_1_t_x. 

1**1 

1**1 

1**1 

> 

1**1 

*s  via,  *d_via,  *p_via. 

% 

1**1 

*w_s_via,  *w_d_via.  '*w_p_via  =  MULL; 

1**1 

* "  • '  • 

1**1 

struct 

wire 

1**1 

{ 

1**1 

int  w_x_location. 

<r. 

1**1 

w_y_1ocation; 

1**1 

struct  wire  parameters 

•*»  * 

1**1 

{ 

1**1 

int  width. 

1**1 

length; 

1**1 

char  w_iayer. 

1**1 

direction; 

*-'!*'*!* 

1**1 

struct  wire_parameters 

1**1 

♦next  segment; 

“  **'.•*' 

1**1 

> 

*w_param; 

k  1**1 

struct  wire 

1**1 

1**1 

*w_l_t_x, 

*w_e_x , 

A  o 

1**1 

1**1 

1**1 

*wire_ptr  =  NULL; 

vCv’li' 

1**1 

1**1 

struct 

call  statement 

/**/ 

t 

1**1 

char  cel InamellSl ; 

-  «'•  ,** 

1**1 

int  cifnum. 

1,  ■*'%*'*. 

1**1 

tran_x,  tran _y. 

1**1 

mir_x.  miry. 

1**1 

rot_x. 

1**1 

X  min,  y..min,  x  max,  y_max; 

n\ 

)**! 

struct  named  ports 

/**! 

{ 

fc  .  " 

1**1 

char  port_name  [15]; 

1**1 

struct  named^ports 

1**1 

♦next  name; 

1**1 

> 

1**1 

*c_ports; 

^■:-v 

1**1  struct  cal i_statement 

1**1  *1_t_name, 

1**1  *e_naine. 

1**1  *g_t_name; 

1**1  } 

1**1  *call  ptr  =  NULL; 

1**1 

1**1  struct  1ter_statement 

1**1  { 

1**1  char  cellname  [151; 

1**1  int  clfnum, 

1**1  x_iters,  y_iters, 

1**1  x_pitch,  y_p1tch; 

1**1  struct  cal l_statement 

1**1  *1_call; 

1**1  struct  1ter_statement 

1**1  *l_t_cifnum.  *e_c1fnum,  *g_t_cifnum; 

1**1  } 

1**1  *1ter  ptr  =  NULL; 

1**1 

1**1  struct  called  cells 

1**1  { 

1**1  char  cellname  [151; 

1**1  Int  clfnum; 

1**1  struct  called_ceUs 

1**1  *next  call ; 

1**1  } 

1**1  *%  calls  =  NULL; 

1**1 

/»<r*»t#**<r*********iit*  Enjj  of  Structure  for  storing  CIF  ************ f 
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♦ 

★ 

* 

Program  Marne:  MOCLL. C 

* 

* 

* 

Version/Oate:  1.0  20  July  1985 

it 

it 

it 

it 

Function:  This  program  is  a  Menu  Driven  Chip  Layout 

it 

it 

Language  System  for  use  in  the  design  of  VLSI 

it 

it 

circuits.  Its  final  product  is  a  file  in  the 

it 

it 

Caltech  Intermediate  Form. 

it 

it 

it 

it 

Usage: 

This  program  must  be  used  with  its  subprograms: 

★ 

it 

CREATE.  DPM,  MODIFY.  INTER,  PRIPLO,  and  FINAL. 

* 

it 

Each  program  is  coded  in  C/80  and  must  be  compiled 

* 

* 

and  assembled  accordingly. 

* 

★ 

* 

* 

Include 

Files  Needed:  STOLIB.C  (including  toupper,  tolower 

* 

* 

alloc,  sizeof,  atoi .  itoa),  MOCLL. H  (TPRINTF.C.  EXEC 

■  C)* 

it 

* 

it 

Author: 

Steven  C.  Morrese,  Capt,  USAF 

* 

it 

* 

ir 

* 

Program 

Hierarchy: 

* 

it 

it 

0.0  MOCLL  Main 

* 

it 

1 

it 

it 

0.1  Initialize 

it 

★ 

1 

it 

* 

* 

1 

0.2  Main_Menu 

it 

it 

♦ 

* 

( 

0.3  Fetch_Run 

1  *" 

it 

if 

A 

it 

1 

1 -  1.0*  CREATE  Hain 

1 

it 

if 

* 

* 

1 

1 -  2.0*  DPM  Main 

1 

it 

if 

31- 

1 

1 -  3.0*  MODIFY  Main 

it 

* 

1 

it 

* 

3lr 

1 -  4.0*  INTER  Main 

1 

it 

if 

* 

* 

1 

1 -  5.0*  PRIPLO  Main 

1 

it 

if 

* 

1 

1 -  6.0*  FINALIZE  Main 

it 

* 

it 

*«**««r***«*********«;***«*********A******4r*****«Vlr*«r***'*'«r****'«r4r4t4r********  j 


« include  “mdcl 1 .h 


/*  Standard  header  used  in  every  program  *! 
/*  in  the  MOCLL  system  even  though  not  every  */ 
I*  program  uses  every  item  defined.  */ 


it 

* 

* 

* 

* 

it 

* 

* 

* 

it 

* 

* 

it 

it 

it 

it 

■k 

it 


Name:  Ha In 
Hodule  Number:  0.0 
Verslon/Oate:  1.0  20  July  1985 

Input  Parameters:  Initialize  variable 
Output  Parameters :  none 

Modules  Called:  Initialize,  Ha1n_Menu,  Fetch_Run 
Calling  Modules:  SAVECELL  Main.  FINALIZE  Main 
Function: 

Control  the  selection  and  running  of  the  other 
programs  In  the  MOCLL  system. 

PDL: 

If  Initialization  message  wanted 
then  Initialize; 

Display  Main  Menu  and  get  response; 

If  not  quit  command 
then  execute  requested  subprogram. 


it 

it 

* 

* 

* 

it 

it 

it 

it 

it 

* 

* 

* 

* 

* 

* 

* 

it 


icititititiiitititititiritirititiritititititititititirititititititicicititi(ititititititititititititititititititicititititititititit'kitititit  j 


main  (argc.argv) 

Int  argc; 
char  **argv(l; 

{ 

char  option; 

option  =  '  ' ; 
if  (argv[l](01  !=«  'N') 
Initial ize  ( ); 
option. =  Main_Menu  (); 
if  (option  !=  'Q* ) 
Fetch  Run  (option); 


y  ★*★*****★************★*******★******;*  IMrllr******************************* 


* 

★ 

it 

Module  Name:  Initialize 

* 

* 

Module  Number:  0.1 

* 

Version/Oate:  1.0  20  July  1985 

* 

* 

Input  parameters:  none 

* 

* 

Output  parameters:  none 

* 

* 

Globa Is  Used:  none 

* 

* 

Modules  Called:  none 

* 

★ 

Cal  1 ing  Modules:  Main(O.O) 

* 

* 

Function:  Print  Introductory  message. 

* 

it 

it 

PDL:  N/A 

* 

* 

«***«***4r****'*****4nllr*«r««1ir***«********«*«**«****4t*******4t***«*4t**4r******  ^ 

Initial Ize  ( ) 

{ 

pr i ntf  ( "\n\n\n\n\n\n\n\n\n\n\n\n " ) ; 

printf  ( "\n  Welcome  to  the  world  of  Doctor  Chill  \n\n'‘): 

printf  ("\n  If  you  don't  want  to  get  these  instructions  "); 

printf  (“\n  simply  type  an  N  after  the  program  name;  'MDCLL  M‘,  \n“); 

printf  ("\n  Anytime  a  question  is  asked  and  return  or  N  is  "); 

printf  ("\n  requested  any  character  will  suvvice  for  the  N.\n"); 


printf  ("\n  \n  ADD  Instructions  on  using  the  system  here  \n\n"); 


printf  ("\n\n  \n\n  Type  return  to  begin:  "); 

whi le  (getc(O)  !=  ‘\n' ); 

printf  ( "\n\n\n\n\n\n\n\n\n\n\n\n" ) ; 


Iiticitititifititi(i(i(iri('kffic’kitirit'ki(i(icitic'ki(icic'ki(icititi(iti(1tici(if'kicl(ici(iti(iti(iciciti(i('k'kicicfe'ki(i('kicicifi(ici( 
*  ★ 

*  Module  Name:  Main_Henu  * 

*  Module  Humber;  0.2  * 

*  Version/Oate:  1.0  20  July  1985  * 

*  Input  Parameters:  none  * 

*  Output  Parameters:  option:  subprogram  to  be  run  * 

*  Globa Is  Used:  none  * 

*  Modules  Called:  none  * 

*  Calling  Modules:  Main  (0.0)  * 

*  Function:  Display  the  available  options  and  ensure  a  valid  * 

*  response  Is  obtained  from  the  user  * 

*  POL:  * 

*  While  response  not  a  valid  option  * 

*  Display  Menu,  * 

*  get  response,  * 

*  return  option.  * 

*  * 

Main_Menu  () 

( 

char  option; 

Int  opt1on_val id; 

opt1on_va11d  =  FALSE; 
while  Toptlon  valid  ==  FALSE) 

{ 

printf  (''\n  \t\t  MDCLL  Main  Menu  \n\n"); 
printf  ("\n  Options  available  are  \n"); 
printf  (‘'\n\t  C  =  Create  a  new  cell  \n"); 

printf  ( "\n\t  0  =  Delete,  place,  or  move  an  existing  cell  \n"); 

printf  ("\n\t  M  »  Modify  an  existing  cell  \n"); 

printf  ("\n\t  I  =  Interconnect  cells  already  placed  \n"); 

printf  ("\n\t  P  =  Print  or  Plot  \n"); 

printf  ( "\n\t  F  =  Finalize  circuit  \n"); 

printf  ("\n\t  Q  =  Quit  to  the  operating  system  \n"); 
printf  ("\n\n  Select  Option  (C,0,M,I,P,F,Q):  " ) ; 
option  =  getc(O); 
if  (option  !=  '\n' ) 
whi le  ( getc(O)  ! =  '\n' ) ; 
printf  ( "\n\n\n\n\n\n\n\n" ) ; 
option  =  toupper  (option); 
switch  (option) 


case  'C 
case  'M' 
case  'P' 
case  'O' 
default 
) 


case  'O'  ; 
case  'I'  : 
case  'F'  : 

opt1on_val1d  =  TRUE;  break; 

printf  ("\n  Option  not  valid  =  *c\n\n' 


option); 


return  (option); 


* 

Module  Marne:  Fetch_Run  * 

Module  Number:  0.3  * 

Version/Date:  1.0  20  July  1985  * 

Input  Parameters:  option:  subprogram  to  be  run  * 

Output  Parameters:  none  * 

Globals  Used:  none  * 

Modules  Called:  Subprograms  in  MDCLL  system  * 

Calling  Modules:  Main  (0.0)  * 

Function:  Ensure  the  requested  subprogram  Is  available  * 

and  then  execute  It.  * 

POL:  * 

Set  filename  to  be  executed;  * 

try  to  access  file  from  on  disk,  * 

while  file  not  available  and  filename  valid  * 

print  error  message  and  get  response,  * 

if  user  wants  to  quit  * 

then  set  file  validity  to  false  * 

else  check  If  file  available  on  disk;  * 

if  file  still  valid  * 

then  execute  the  subprogram.  * 


icit'kitititifitififitifiticitititititititit'kiticif'kicititit'kifititieicitic'kit'kititifif'kititititicit'kicit’kirit'kitic’kit'k'k'k'k'k'kit  j 

Fetch  Run  (option) 

{ 

char  ^filename; 

int  fi1e_valid; 

FILE  »fopen( ).*fp; 

fi1e_valid  =  TRUE; 

if  (option  ==  'C')  filename  =  "CREATE.COM"; 
else  if  (option  ==  '0')  filename  =  "0PM. COM"; 

else  if  (option  ==  'M')  filename  =  “M0DIFY.COM"; 

else  If  (option  ==  'I')  filename  =  "IMTER.COM"; 

else  if  (option  ==  'P')  filename  =  "PRIPLO.COM"; 

else  if  (option  ==  ‘F’)  filename  =  "FINALIZE.COM"; 


“M0DIFY.COM"; 
"IMTER.COM"; 
"PRIPLO.COM"; 
"FINALIZE. COM" 


fp  =  fopen  (filename,  "r"); 

while  ((fp  ==  MULL)  &&  (f11e_valid  ==  TRUE)) 


printf  ("Place  disk  with  file  *s  In  the  active  drive\n\n",  filename); 
printf  ("Hit  RETURN  to  continue  or  Q  to  exit  system:  "); 
if  (getc(O)  !=  'Q' ) 
fi1e_va1id  =  FALSE; 
else  fp  =  fopen  (filename,  "r"); 

} 

if  (f11e_valid  =  TRUE) 

{ 

fclose  (fp); 

exec  (filename,  "  "); 

) 

) 

Minclude  "stdl ib.c" 


^itificiiititititicicitititiciciricitificititific'kit'kititit-k'kicic'k'kicfc’k'kicititieitit'k’kic'kiticicic'k'k'k'kit'k'kic'kit'kicicitiric'k 


*  i( 

*  Program  Name;  CREATE. C  * 

*  Version/Oate:  1.0  22  July  1985  * 

*  * 


it 

* 

it 


Function:  This  subprogram  to  HOCLL.C  creates  a  new  cell  In  * 
the  Caltech  Intermediate  form.  * 

* 


*  Library  Files  Needed:  STDLIB.C.  PRINTF.C,  SCANF.C,  EXEC.C  * 

*  ★ 


*  Program  Hierarchy:  See  next  page 

it 

iti(ititititititititititititititititititititfticitititi(ititiiitifititicitit1tititi(itiriti[ititit**iriti(ititit'kiticiticitieititititititir 


* 

★ 

/ 


^Include  “mdcl 1 .h" 


the  following  filler  was  added  to  ensure  data  Is  not 

overwritten  when  the  subprogram  SAVECELL  Is  executed. 

itiricititicititilitititititic'kitititititititititit'ititilitititititititftit'kitititicititititititititititititirit'kititititilirit  j 


#asm 

filler;  DS 
Nendasm 


2500H 


Jifititir'kiiiirir'kiririrfr'kifir'knifif'kititicit'kitit^fcit'kiciticicic'kititiricit'kicicic'k'kic'k'kit'kiticicit'kiaf'kickidcidddcic 


1.0  CREATE  Main 


-  1.1  Name_cel1 

-  1.2  C_Menu 

1 - 1.2.1 

— 1.3  Implement 


Get_0ption 


1.3.1  Oef_Port 

1 - 1.3. 1.1  0ef_Layer 

I - 1.3. 1.2  Get_Num 

I - 1.3.1.3r  Port_Tree 

I - 1.2.1*  6et_0pt1on 


-  1.3.2  0ef_Rectang1e 

I - 1.3. 1.1*  Def_Layer 

I - 1.3. 1.2*  Get_Num 

I - 1.3.2.1r  Rect  Tree 

I - 1.2.1*  Get_0pt1on 

-  1.3.3  0ef_W1re 

I - 1.3. 1.1*  Oef  Layer 

I - 1.3. 1,2*  GeOum 

1 - 1.3.3.1r  S  wire  Tree 

I - 1.3. 3. 2  Get_W_0ption 

1 - 1.3.3.3r  Place  Wire_Parameters 

I - 1.2.1*  Get_0pt7on 

-  1.3.4  Oef_Via 

I - 1.3. 1.1*  Def_Layer 

I - 1.3. 1.2*  Get_Num 

I - 1.3.4. Ir  Via_Tree 

I - 1.2.1*  Get_0ption 

-  1.3.5  Oef  Flash 


1.3.6 


Print_Hork  * 

—  1.2.1*  Get_0pt1on  * 

—  1.3.6.1r  Malk_P_Tree  * 

—  1.3.6.2r  Walk  R_Tree  * 

—  1.3.6.3r  Malk_W_Tree  * 

I - 1.3.6.3.1r  Segment_Tree  * 

—  1.3.6.4r  Wa1k_V1a_Tree  * 

—  1.3.6.5r  Wa1k_C_Tree  * 

—  l.3.6.6r  Walk  I  Tree  * 


*  I - 1.3.7  Save  Cell  * 

*  I - 1.3. 7.1  Store_Ptrs  * 

*  I - 7.0  SAVECELL  Main  * 


Jirir'kicicicigifitititiciticieiciritfrigic'klt'kit'k'kitif'kicif'kitititfticit'kic'k'kif'k'kicif'kicic'kic'kic'kit'k'kic'kifitit’k'k'k'kic'k'k 
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Module  Name:  Main 
Module  Number:  1.0 
Version/Oate:  1,0  21  Aug  1985 
Input  Parameters;  none 
Output  Parameters:  none 
Global s  Used:  none 

MoQUles  Called:  Name_Ce11.  C_Henu.  Implement 

Calling  Modules;  MDCLL  program 

Function: 

Name  a  new  cell.  Display  options  available,  and  then 
Implement  the  desired  option  (place  the  needed  wires 
in  the  physical  layout  of  a  VLSI  circuit). 

POL: 

While  name  Is  not  already  in  use 
Determine  name  for  new  cell; 

Display  menu  and  get  option; 

While  option  other  than  quit 
Implement  desired  option. 

Display  menu  and  get  option. 
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H’H’Hr>^*:l^HrHrHrH’Hr3^*i^HrHrHr:HHr*HrHrrHHrHrHrHrHrHrHrHrHrHrHrHrHrHrHrHrHrHrHrHrHrHrHrHrHrHr1^HrHrHrHrHrHrHrrHHrHrHrHrHrHr’HHrHrHrHrHrHr  y 


ma<n( ) 

{ 

int  name_va}  id,  on_di sk; 

char  option. 

ceDname  115],  filename  112); 


name_val1d  =  FALSE; 
while  (name  valid  ==  FALSE) 

{ 

prlntf  ("\n\n  Enter  cell  name  for  new  cell;  "); 

Name_Cell  (&on_disk,  filename,  cellname); 
if  (on_dislc  ==  FALSE) 

( 

prlntf  ("\nCen  *s  will  be  stored  as  file  *s\n",  cellname,  filename) 
namevalid  =  TRUE; 

} 

else  prlntf  ( "\n\n  Name  *s  already  in  use.\n\n",  cellname); 

} 

while  ((option  =  C_t1enu  (cellname))  !=  'Q') 

Implement  (option,  filename,  cellname); 

) 


Ninclude  "cre81 ib. 1 ib" 
Ninclude  "stdlib.c" 
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#1fneed  Name_Ce11 

ficictcicit-kiticicic'ktcicitit'kic'k*ic**icik***1cfe***it*ietcicic'kiti(*it*ieitigitfriie*iicititi(i(**iiei(ie-kiic*'k’k'k'kiciri[ie 
*  * 

*  Module  Name:  Name_Cell  * 

*  Module  Number:  1.1  * 

*  Verslon/Oate:  1.0  21  Aug  1985  * 

*  Input  Parameters:  none  * 

*  Output  Parameters:  on_disl(,  cell  name,  filename  * 

*  Globa  Is  Used:  none  * 

*  Modules  Called:  none  * 

*  Calling  Modules:  CREATE  Main,  0_lmplement,  MODIFY  Main,  * 

*  PRIPLO  Main,  FINALIZE  Main  * 

*  Function:  Name  a  new  cell,  ensure  the  name  Isn't  already  * 

*  In  use,  and  Initialize  the  output  file  on  disk.  * 

*  PDL :  * 

*  Get  cell  name  from  user;  * 

*  Obtain  filename  from  cellname  for  new  cell;  * 

*  If  filename  already  In  use  * 

*  then  set  on_d1sk  =  TRUE,  * 

*  else  filename  not  yet  used  (on_d1sk  =  FALSE).  * 

****<f*************************************nt************i(it****************y 

Name_Cell  (on_d1sk,  filename,  cellname) 


i  nt 

*on_d1sk; 

char 

*f i lename. 

*cel 1  name; 

1 

int 

i; 

FILE 

*fopen( ) ,*fp; 

i  =  0; 

while  ( (cel Inamell 1  =  toupper  (getc(O)))  !=  '\n') 

++1 ; 

cel Inamell]  =  '\0'; 

1  =  0; 

while  ( (f1 1  enamel  1 ]  =  cel Inamell])  !=  '\0’ ) 

++i; 

filenameli]  =  f1  lename(++i ]  =  'C; 

f 1 lenamel++i ]  =  'I';  f i lenamel++i ]  =  'F'; 
f i lenamel++i ]  =  '\0‘; 
if  (cel Inamell]  ==  ' : ' ) 

{ 

i  =  0; 

while  ( (cel Inamel i ]  =  cell  name (2  +  i])  !=  ’\0' ) 
) 

fp  =  fopen  (filename,  "r"); 
if  (fp  !=  NULL) 

{ 

fclose  (fp); 

*on_disk  =  TRUE; 

} 

else  *on_d1sk  =  FALSE; 


■C; 

=  'F' ; 


=  cel  1  name  12  +  i  ] )  !  = 
"r"); 


•\0'  ) 


Nendif 


#ifneed  C_Menu 


* 

k 

* 

Module  Name:  C_Henu 

k 

* 

Module  Number:  1.2 

k 

* 

Version/Oate:  1.0  22  July  1985 

k 

•k 

Input  Parameters:  cellname 

k 

* 

Output  Parameters:  option 

k 

* 

Global s  Used:  space_used.  AVAIL_SPACE 

k 

* 

Modules  Called:  Get_0pt1on 

k 

* 

Calling  Modules:  Main  (I.O) 

k 

* 

Function:  Obtain  a  valid  option  from  the  user 

k 

k 

POL: 

k 

k 

While  not  a  valid  option 

k 

k 

Display  options; 

k 

k 

Get  option; 

k 

k 

check  validity  of  option; 

k 

k 

k 

return  option. 

* 

*******i»**4nllr***4r**«4r»*****4r4r****4r**«**1lr****«*****4r*******4r******«**'*****  j 

C_Menu  (cell name) 
char  *cellname; 

{ 

char  option; 

int  opt1on_val id, 

space_Teft; 

option_val1d  *  FALSE; 
while  (option_val Id  *=  FALSE) 

{ 

space_left  =  AVAIL__SPACE  -  space_used; 

print?  ( "\n\n\t\t\tMemory  used:  Xd  space  left:  Xd\n" ,space_used,space_left) ; 
printf  ("\nOptions  available  for  cell  Xs  are:\n\n",  cellname); 
printf  ("\nDefine  a  :\t\t\tor :\n" ) ; 

printf  (”\n  R  =  Rectangle  (box)\t\t  P  =  Print  work  accompl i shed\n" ) ; 

printf  ("\n  W  =  Wire  \t\t  E  =  Exit  to  main  menu\n"); 

printf  ("\n  V  =  Via  \t\t  after  saving  fi1e\n”); 

printf  ("\n  F  =  round  Flash  \t\t  Q  =  Quit  to  system\n"); 

printf  ("\n  I  =  Interconnection  Port\n"); 

printf  ( "\n\t\t\tCurrent  default  layer  is  Xc\n",  layer); 

printf  ("\nSelect  Option  (R.W.V.F. I .P.E.Q) :  ”); 

option  =  Get_0pt1on  (); 

if  (option  ==  'R'  ||  option  ==  ’P'  ||  option  ==  'W' 

1 1  opt  ion  ==  'V  II  option  ==  'F'  ||  option  ==  'I' 

lloption  ==  'Q'  II  option  ==  'E') 

optionvalid  =  TRUE; 

else  printf  ("Option  not  valid\n\n"); 

} 

printf  ( "\n\n\n\n\n\n\n\n\n" ) ; 
return  (option); 

} 

iiendif 


TN^V.'^T.'VT.'V  '.•7'.'» '.■'!  v."» 


#ifneed  Get_Option 

I1t1ciiliititii***ic*1c*ifk****iicii**it*****1c*inelt1iint**ir-k-k****lc********************1c1i*ii 
*  * 


* 

★ 

* 

* 
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Module  Name:  6et_0pt1on 

Module  Number:  1.2.1  * 

Version/Oate:  1.0  5  August  1985  * 

Input  Parameters;  none  * 

Output  Parameters:  option  * 

Globa Is  Used;  none  * 

Modules  Called:  none  * 

Calling  Modules:  C_Menu.  Oef_Layer.  Def_Rectangle,  Def_Hire.  * 
Def_V1a,  Pr1nt_Work,  Pr1nt_Rect.  Print_Wire,  Def_Port,  * 

Print_V1a,  DPM_Main,  D_Implement.  Cal l_Parameters,  Place_Call  * 
C_Port_Mames,  Mod_Call,  Mod_Iter,  MODIFY  Main,  Det_Mod,  * 

M_Menu.  Mod_Port.  Mod_Rect.  Hod_Mire,  Mod_V1a,  PRIPLO  Main,  * 
FINALIZE  Main.  Process_Cal1  * 

Function:  Get  a  single  character  option  from  the  terminal  * 

POL;  * 

Get  a  character  from  the  user;  * 

Convert  it  to  upper  case;  * 

Continue  geeting  characters  until  a  carriage  return;  * 

return  the  first  character.  * 

Hr 


**»»**»*HrHr**HfHrHfHf*HrHrHrHrHfHrHfHfHrWHrHr*Hr*HfHf*Hr1kHfHfHrHrHfHrHrHrHfHfHrHfHr*HrHrHr*HfHrHr**HrHrHrHfHrHf**HrHrHrHf^ 


Get_0ption  () 

{ 

c'lar  option; 

option  =  toupper  {getc(O)); 
if  (option  !=  '\n‘ ) 
while  (getc(O)  !=  '\n ' ) ; 
return  (option); 

} 

#endif 


#ifneed  Implement 

^ieitic^itiriticiciriticit'kitieitltititiriritic'kitlciciticicieiticiiicititic'kit'k'kitic'k'k'kic'kicicitit'k'kic'kic-kicit'k'k'kirik'k'kic'icit 
it  * 


★ 

ic 

* 

* 

* 

* 

★ 

* 

* 

* 

* 


Module  Name;  Implement  * 

Module  Number;  1.3  * 

Version/Date;  1.0  23  July  1985  * 

Input  Parameters;  option,  filename,  cellname  * 

Output  Parameters;  none  * 

Modules  Called;  Def_Port.  0ef_Rectang1e,  Def_W1re,  Def_V1a,  * 

Def_Flash,  Pr1nt_Morl(,  Save_Ce11  * 

Calling  Modules;  Main  (1.0)  * 

Function;  Process  requested  option  * 

POL;  N/A  * 

■k 


**ic*ki<ii*****if**ic*k**kir***k***k***********1c*k*irkk**k*ifti'k-kmf*ii***kk**k-kifkli  ^ 


Implement  (option, 
char  option, 

*f 1 1 ename , 
*cel 1  name; 

{ 

If  (option  ==  ‘  I  ■ ) 
else  If  (option  == 
else  If  (option  *= 
else  If  (option  »= 
else  If  (option  »= 
else  if  (option  »= 
else  If  (option  «= 
) 


filename,  cellname) 


Oef  Port  ( ) ; 

'R' )  Def  Rectangle  ( ); 

■W)  DeflWIre  (); 

■V)  Def_V1a  (); 

•F* )  Def  Flash  (); 

■P*)  Pr1nt_Work  (); 

'£')  Save_Ce11  (filename,  cellname); 


Nendlf 


#1fneed  Def_Port 

^★lHlr****i(lt**llrlltilf******1lt**1lt********#*l(lt*i«(**<f»!»r*********************i»********* 


Module  Name:  Def_Port 

Module  Number:  1.3.1 

Version/Date:  1.0  7  September  1985 

Input  Parameters:  none 

Output  Parameters:  none 

Globa Is  Used:  port_ptr 

Modules  Called:  0ef_Layer.  Get_Mum,  Port_Tree.  Get_0pt1on 

Cal  1 fng  Modules:  Implement 

Function:  Define  an  Interconnection  port 

POL: 

While  not  finished  placing  ports 

Enter  port  name,  location,  and  layer. 

Place  port  In  structure. 


* 

★ 

* 

* 
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HrHr*Hr*:H^HrHrHrHrHrHrHrHrHrHrHrHrHr*HrHrHrHrHrHrHrHrHrHrHr*HrHrHrHrHr*Hr*HrHr*HrHrHrHrHrHrHrHrHrHrHrHrHrHrHrHrHrHrHrHrHrHrHrHrHrHrHrHrHry 


Oef_Port  () 

{ 

char  portname  [15]; 

Int  1,  finished,  p_x,  p_y; 

printf  ( ''\n\n\n\n\t\t  Ready  to  place  an  Interconnection  Port  \n\n\n\n’'); 

finished  =  FALSE; 

while  (finished  ==  FALSE) 

{ 

printf  {"\n  Enter  the  port's  name:  "); 

1  =  0; 

while  ((portname  (ij  =  getc  (0))  !=  ‘\n')  ++1; 

portname  [1]  =  'NO'; 

printf  ("Nn  Enter  the  port  layer  \n"); 

Oef_Layer  (FALSE); 

printf  ("\n\t\t  X  Location:  "); 

p_x  =  Get_Num  ( ) ; 

printf  ("\n\t\t  Y  Location:  “); 

p_y  =  Get_Num  ( ) ; 

Port_Tree  (portname,  p_x,  p_y,  &port_ptr); 

printf  ("\n  Do  you  want  to  place  another  port  (ret  or  N):  "); 

If  (Get_0pt1on  ()  !=  '\n')  finished  =  TRUE; 

} 

} 


tVV i 


#end1f 


#ifneed  Def_Layer 

y***««*'«r**********4r**********«r***«r**1lr***:l^*«4r************4r*»****  ********** 


* 

* 

* 

Module  Name:  Def_Layer 

* 

* 

Module  Number:  1.3.1. 1 

it 

* 

Version/Date:  1.0  23  July  1985 

ic 

* 

Input  Parameters:  layer_valid 

it 

* 

Output  Parameters:  none 

it 

* 

Globa Is  Used:  layer 

it 

★ 

Modules  Called;  Get_0ption 

ic 

* 

Calling  Modules:  Oef_Rectangle,  0ef_Port, 

Def_W1re.  Def_Via. 

* 

★ 

M_Implement,  Mod_Port 

* 

* 

Function:  Change  the  default  layer 

* 

* 

POL: 

ic 

* 

if  already  have  a  valid  layer 

* 

* 

determine  if  want  default  or  change  in 

layer 

ic 

* 

if  want  to  change  layer  set  layer  valid 

1  to  false 

* 

* 

while  layer  not  valid 

* 

* 

Print  options; 

★ 

# 

Get  option. 

* 

* 

Check  validity. 

* 

* 

ic 

1iii-**it**1i*-ii**if***-k**ii-kieit**iic**iitit*iic*itiifk****'k1tit*ie1eit*iiir1t*ir*itir'k1i***1t****ifk1titiiit  f 

Def_Layer  ( layer_val id) 

Int  layer  valid; 

{ 

if  (layer  valid  ==  TRUE) 

{ 

printf  ("\n\n\n\nOo  you  want  the  default  layer  to  be  %c  (ret  or  N):  ".layer) 
if  (Get_0ption  ( )  !*  'Nn' ) 
layer  valid  =  FALSE; 

} 

while  (layer_valid  ==  FALSE) 

{ 

printf  ("Available  layers  are:  \n\tF  =  First  level  metal  \n\tS  =  Second  "); 
printf  ("level  metal  \n\tO  =  Diffusion  \n\tP  =  Polysi 1 icon\n\n" ) ; 
printf  ("\nSelect  a  layer  (F.S.D.P);"); 
layer  =  Get_0ption  (); 

if  (layer  ==  'F'  ||  layer  ==  'S'  ||  layer  ==  '0'  ||  layer  ==  'P') 
layer_valid  =  TRUE  ; 

else  printf  ("\n\n\t  Not  a  valid  layer  \n\n"); 

) 

} 


#endif 


tfifneed  Get_Num 


Module  Name:  Get_Num 
Module  Number:  1.3. 1.2 
Version/Date:  1.0  1  August  1985 

Input  Parameters:  none 
Output  Parameters:  number 
Globals  Used:  none 
Modules  Called:  none 

Calling  Modules:  Def  Mire.  Def_Port,  Def_Rectangle,  Oef  Via, 
Get_Port.  Get_Rect.  Get_M1re.  6et_Vla.  6et_CaTl. 
Get_C_Parameters.  6et_Iter.  Cal 1_Parameters. 
Iter_Parameters.  M  Implememt,  Mod_Port,  Mod_Rect, 
Mod_H1re.  Mod_V1a  ~ 

Function:  Get  a  number  Input  from  the  user 
POL: 

While  the  Incomming  character  Is  not  a  blank,  comma, 
semicolon,  return,  or  close  parentheses 
Include  tne  character  In  the  digit  string; 

Add  the  end  of  string  marker; 

Convert  the  ascii  string  to  an  Integer; 

If  the  Input  was  from  the  user  Instead  of  from  disk 
continue  getting  characters  until  a  return; 
return  the  number. 
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Get_Num  (fp) 
FILE  *fp; 


{ 

int 


i.c,  number; 


char  a_d1git[16]; 

1=0; 

while  ((c=getc(fp))  !=  '  '  M  c  !=  &&  c  !=  &&  c  !=  An'  &&  c!=')’) 

a_d1g1t[i++l  =  c; 
a_d1g1t[i]  =  '\0'; 
number  =  atoi  (a_d1g1t); 
if  (fp  ==  0  «.&  c  !=  An’  ) 
while  (getc(fp)  ! =  '\n ‘ ) ; 
return  (number); 

} 

Nendlf 


#ffneed  Port_Tree 

y *★»***!»***★**★**********★***************★★****★**★********★»★★******★*** 

Module  Name;  Port_Tree 
Module  Number:  1.3. 1.3 
Version/Date:  1.0  7  September  1985 
Input  Parameters;  p_ptr.  portname,  p_x.  p_y 
Output  Parameters:  none 
Globa Is  Used:  space_used.  layer 
Modules  Called:  Port_Tree  (recursion) 

Calling  Modules:  Port_Tree,  Def_Port,  Get_Port 
Function:  Place  a  port  In  the  1nter_ports  structure 
POL; 

If  port  location  Is  empty 
allocate  memory, 
place  information; 
else  go  to  next  port  location. 


*************HtHr*********»**********»lHlr***i»rlit****1lr*Klt*llr****ilr**>Hlrilt*tlt**il:ilt*i***y 


Port_Tree  (portname,  p_x,  p_y,  p_ptr) 

char  *portname; 

struct  fnter_ports  **p_ptr; 

( 

int  1 ; 

if  (*p_ptr  ==  NULL) 

{ 

space_used  =  space_used  +  sizeof  (struct  inter_ports ) ; 
*p_ptr  =  alloc  (sizeof  (struct  inter_ports)); 

(*p_ptr )->next_port  =  NULL; 
i  =  0; 

while  ( ( (*p_ptr)->port_name(1 ]  =  portnamefi])  !=  '\0’)  ++1; 
(*p_ptr)->port_layer  =  layer; 

(*p_ptr )->x_loc  =  p_x; 

(*p_ptr )->y_loc  =  p_y; 

} 

el  se 

Port  Tree  (portname,  p_x,  p_y,  &(*p_ptr)->next_port); 

} 
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Nendif 


#1fneed  Def_Rectangle 

y******»**Kt*******<l:**1lr**llr**»*******llr***********)lr*************ilr*llt*>Hlr»iilr**** 
*  * 
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Module  Name;  Def_Rec tangle 
Module  Number;  1.3.2 
Verslon/Oate;  1.0  5  August  1985 
Input  Parameters;  none 
Output  Parameters;  none 

Global s  Used;  layer,  f_rect,  s_rect,  d_rect.  p_rect 
Modules  Called;  Oef_Layer,  Rect_Tree.  Get_Num,  Get_0ptlon  * 

Calling  Modules;  Implement  * 

Function;  Define  rectangle  (boxes)  parameters  * 

PDL;  * 

Define  layer;  * 

While  not  finished  placing  rectangles  * 

While  not  finished  placing  rectangles  current  default  layer  * 
Input  height,  length,  x.y  location;  * 

Place  rectangle  In  tree  structure;  * 

If  want  to  place  another  rectangle  In  a  different  layer  * 

Define  layer.  * 


irifit****itit**ir*itirir*iririfir»irit**irifiritif*WW*iririt**ir*ir*itir*irWititir*itir***it*iritilr*itir*ir*ilrifir^ 

Oef  Rectangle  () 

{ 

Int  finished,  f1n1_1ayer,  r  h,  r_l ,  r  x,  r _y; 
printf  ( "NnNnXnXtXtU  READY  TO  PLACE  A  RECTANGLE  \n\n\n"); 

Oef  Layer  (TRUE); 
finished  =  FALSE; 
while  (finished  ==  FALSE) 

{ 

f1n1_layer  =  FALSE; 
while  (f1n1_1ayer  ==  FALSE) 

{ 

printf  ("\n\nlnput  Rectangle  height, length,  and  "); 
printf  ("x,y  location  of  bottom  left  corner;\n"); 
printf  (”\n\t\t  Height;  ");  r_h  =  Get_Num  (); 

printf  ("\n\t\t  Length;  ");  r_1  =  GetNum  (); 

printf  ("\n\t\t  X  Location;  ");  r_x  =  Get_Num  (); 

printf  (''\n\t\t  Y  Location;  ");  r_y  =  Get_Mum  (); 

If  (layer  ==  'F')  Rect_Tree  (r_h,  r_l ,  r_x,  r_y,  &f_rect); 
else  If  (layer  ==  'S')  Rect_Tree  (r_h,  r_l ,  r_x,  r_y,  &s_rect); 

else  If  (layer  ==  '0')  Rect_Tree  (r_h,  r_l ,  r_x,  r_y,  &d_rect); 

else  If  (layer  ==  'P')  Rect_Tree  (r_h,  r_l ,  r_x,  r _y,  &p_rect); 

printf  ("\n  Another  Rectangle  In  this  layer  (return  or  N);  "); 
if  (Get_0pt1on  ()  !=  '\n')  fini  layer  =  TRUE; 

) 

printf  ("\n  Another  Rectangle  in  any  layer  (return  or  N);"); 

If  (Get  OptlonO  !=  'Xn')  finished  =  TRUE; 
else  Oef  Layer  (FALSE); 

} 

} 

#end1f 


#ifneed  Rect_Tree 

y ************************************************************************ 

*  * 

*  Nodule  Marne:  Rect_Tree  * 

*  Nodule  Number:  1.3. 2.1  * 

*  Version/Date:  1.0  25  July  1985  * 

*  Input  Parameters:  r_h,  r_l ,  r_x,  r _y,  rect  * 

*  Output  Parameters:  none  * 

*  Globa Is  Used:  space_used  * 

*  Nodules  Called:  Rect_Tree  (recursion)  * 

*  Calling  Nodules:  Oef_Rectangle.  Rect_Tree.  Get_Rect,  Nod_Rect  * 

*  Out_W_Segment  * 

*  Function:  Place  rectangle  In  proper  position  In  tree  * 

*  based  on  x  location.  * 

*  POL:  If  rectangle  being  examined  Is  empty  * 

*  then  * 

*  A1  locate  Space,  * 

*  Place  height,  length,  x,y  location  In  structure;  * 

*  else  If  X  to  be  placed  <  x  examined  * 

*  then  Enter  Tree  to  the  left;  * 

*  else  if  X  to  be  placed  =  x  examined  * 

*  then  Enter  Tree  to  the  middle;  * 

*  else  If  X  to  be  placed  >  x  examined  * 

*  then  Enter  Tree  to  the  right.  * 

*  * 

Rect_Tree  {r_h.  r_l ,  r_x,  r _y,  rect) 

struct  rectangle  **rect; 

{ 

if  (*rect  ==  NULL) 

1 

space_used  =  space_used  +  sizeof  (struct  rectangle); 

*rect  =  alloc  (sizeof  (struct  rectangle)); 

(*rect)->less_than_x  =  (*rect)->equals_x  =  (*rect)->greater_than_x  =  NU 
(*rect)->height  =  r_h; 

(*rect)->1ength  =  r_l ; 

(*rect)->x_location  =  r_x; 

(*rect)->y_location  =  r  _y; 

) 

else 

1 

if  ('•_x  <  (*rect)->x_lrcation) 

Rsc!’_Tree  {r_h,  r_l ,  r_x,  r_y,  &(*rect)->1ess_than_x); 
else  if  (r_x  ==  (*rect)->x_locat1on) 

Rect_Tree  (r_h,  r_l ,  r_x,  r _y,  4(*rect)->equals_x); 
else  if  (r_x  >  (*rect)->x_location) 

Rect_Tree  (r_h,  r_l ,  r_x,  r_y,  &(*rect )->greater_than_x ) ; 

) 

) 

Nendif 


V 
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»1fneed  Def_W1re 

y************************************************************************ 
*  * 

*  Module  Name:  0ef_W1re  * 

*  Module  Number:  1.3.3  * 

*  Version/Date:  1.0  28  July  1985  * 

*  Input  Parameters:  none  * 

*  Output  Parameters:  none  * 

*  Globa  Is  Used:  layer,  seg_ptr,  wlre_ptr  * 

*  Modules  Called:  Def_Layer.  Get_Mum,  S_Wire_Tree,  Get_0pt1on  * 

*  Get_M_0ption.  Place_Hire_Parameters  * 

*  Calling  Modules:  Implement  * 

*  Function:  Define  a  wire  similar  to  CLL  * 

*  POL:  * 

*  While  not  finished  placing  wires  * 

*  Input  x.y  location  for  start  of  wire  * 

*  Start  the  wire  definition  In  memory  * 

*  Get  option  for  next  segment  of  wire  * 

*  while  not  finished  adding  segments  to  this  wire  * 

*  If  option  was  ‘ 1 '  * 

*  then  define  layer  * 

*  else  If  option  was  ‘w*  * 

*  then  Input  width  * 

*  else  If  option  was  ’b‘,  'f',  'u',  or  'd'  * 

*  then  Input  length  of  segment  and  place  wire  parameters  * 

*  * 

*************************************************************************  j 

Oef_Wire  () 

{ 

int  finished, 

w_x, 

w_y. 

width, 
tempwldth, 
length; 
char  option; 

width  =  4; 

printf  ("\n\n\t\t  READY  TO  PLACE  A  WIRE\n\n“); 

finished  =  FALSE; 

while  (finished  ==  FALSE) 

{ 

printf  ( "\n\n  Inj'Jt  x  and  y  location  for  beginning  of  wire\n''); 

printf  ( "\n\t\t  >  Location:  "); 

w_x  =  Get_Num( ) ; 

printf  ( "\n\t\t  Y  Location:  ”); 

w_y  =  Get_Num  ( ) ; 

S_Wire_Tree  (w_x,  w_y,  4w1re_ptr); 
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while  ((option  =  6et_W  Option  (width))  !=  'e') 

{ 

If  (option  ==  ■ 1 ' ) 

( 

If  (layer  !=  ‘F' ) 

( 

prlntf  ("\n  Only  allowable  layer  change  Is  to  first  metal  \n") 
printf  ( "Xn  Default  layer  changed  to  F  \n"); 
layer. =  'F*; 

} 

else  Oef_Layer( FALSE); 

} 

else  If  (option  ==  'w* ) 

( 

printt  (“\n  Input  width  or  return  tor  default  ot  »d;  ".width); 
temp  width  =  (iet_Num  (); 
if  (temp_w1dth  !=  0) 
width  =  tempwldth; 

} 

else  if  (option  ==  ‘b‘  |1  option  ==  'f  ||  option  ==  'u' 

1 1  option  ==  'd' ) 

{ 

printf  ("\n\t  Input  length  of  this  segment;  "); 
length  «  6et_Num  (); 

Place  W1 re_Parameters  (width,  length,  option,  seg  ptr); 

} 

printf  ("\n\n  Oo  you  want  to  place  another  wire  (return  or  M):  "); 

If  (Get_ Option  ()  !=  '\n')  finished  =  TRUE; 


01 f need  SMIreTree 

^ieiKi(i(ititir'kicititiciricicir*i(ie'kititiciti(i(itititi(iticitititfcititicit'kititieic'kitir'kie'kiti(i('ki(ifiti<i(icfci(ici(i(icicititic* 
*  * 

*  Module  Name;  S_Mire_Tree  * 

*  Module  Number:  1.3. 3.1  * 

*  Version/Oate;  1.0  1  August  1985  * 

*  Input  Parameters;  w_x,  w_y,  ptr  * 

*  Output  Parameters;  none  * 

*  Global s  Used:  space_used  * 

*  Modules  Called;  S_W1re_Tree  (recursion)  * 

*  Calling  Modules;  Def_Mlre,  S_M1re_Tree,  Get_W1re,  Mod_Wire  * 

*  Function:  Initial l2e  the  memory  location  for  storing  the  wire  * 

*  POL :  * 

*  If  the  current  pointer  doen't  point  to  a  structure  * 

*  then  * 

*  allocate  enough  space  for  the  structure  to  fit,  * 

*  assign  the  pointer  to  this  space,  * 

*  set  the  segment  pointer,  * 

*  place  the  beginning  x,y  location;  * 

*  else  * 

*  if  X  to  be  placed  <  x  examined  * 

*  then  enter  wire  tree  to  the  left;  * 

*  else  if  X  to  be  placed  =  x  examined  * 

*  then  enter  wire  tree  to  the  middle;  * 

*  else  if  X  to  be  placed  >  x  examined  * 

*  then  enter  wire  tree  to  the  right.  * 


<r**^**<t«n»*Hr*#******<r******t>r**ilr**<i:*Wllr*»**»*iltKt**Kr*****************Ht*******  y 

S_Mire  Tree  (w_x,  w_y,  ptr) 
struct  wire  **ptr; 

{ 

if  (»ptr  ==  NULL) 

{ 

space_used  =  space_used  +  sizeof  (struct  wire); 

*ptr  =  alloc  (  sizeof  (  struct  wire  )  ); 

(*ptr)->w_l_t_x  =  (*ptr)->w_e_x  =  (*ptr )->w_g_t_x  =  NULL; 

(*ptr )->w_param  =  NULL; 
seg_ptr  =  &(*ptr )->w_param; 

(*ptr )->w_x_location  =  w_x; 

(*ptr )->w_y_locat1on  =  w_y; 

) 

else 


'.-'Sv 
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if  (w_x  <  (*ptr )->w_x_location) 

5_W1re_Tree  (w_x,  w_y,  &(*ptr)->w_l_t_x); 
else  if  (w_x  ==  (*ptr )->w_x_location) 
S_H1re_Tree  (w_x,  w_y,  &( *ptr )->w_e_x ) ; 
else  if  (w_x  >  (*ptr)->w_x_Iocation) 

S_Wire_Tree  (w_x,  w_y,  &(*ptr)->w_g_t_x); 

} 

} 

#endif 
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#ifneed  GetWOption 

^  **********  J^*******<r************************************************^**** 
*  * 


* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 
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Module  Name:  Get_W_Option 
Module  Number;  1.3. 3. 2 
Version/Oate;  1.0  1  August  1985 

Input  Parameters;  width 
Output  Parameters;  none 
Globa  Is  Used;  layer 
Modules  Called:  none 
Calling  Modules;  DefWire 

Function;  Get  user's  response  for  placing  segments  of  wires 
PDL: 

while  not  a  valid  response 
Print  options; 

Get  Response; 


* 

■k 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 


************************************************************************ ! 

Get_W_Option  (width) 


{ 

int  option_val id; 

char  option; 


5' 


r. 

t. 


option_val id  =  FALSE; 
while  (opt1on_val id  ==  FALSE) 

{ 

printf  ( "\n\n\t\t\t\t  Memory  used;  *d  \n",space_used); 
printf  ("\n  Do  you  want  to  "); 

printf  ("\n\t  L  =  change  Layers  \t  default  layer  =  *c",  layer); 
printf  ( "\n\t  W  =  change  Width  \t  default  width  =  W,  width); 
printf  ("\n\t  B  =  move  Backwards  (left)  \n\t  F  =  move  forwards  (right)"); 

printf  ("\n\t  U  =  move  Up  \n\t  D  =  move  Down  "); 

printf  ("\n\t  E  =  Exit  this  wire  \n  SELECT  OPTION;  "); 
option  =  to  lower  (getc(O)); 
if  (option  !=  '\n' ) 
while  (getc(O)  !=  '\n'); 

if  (option  ==  '1'  II  option  ==  'w'  II  option  ==  'b'  ||  option  ==  'f 

lioption  ==  ‘f  II  option  ==  'u'  I)  option  ==  'd'  ||  option  ==  'e') 

optionvalid  =  TRUE; 

else  printf  ( "\n  Option  Not  Valid  \n”); 

} 

return  (option); 

) 

#endif 
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Mifneed  P)ace_Wire_Parameters 

*  * 

*  Nodule  Name:  P1ace_Wire_Parameters  * 

*  Module  Number:  1.3. 3. 3  * 

*  Verslon/Oate:  1.0  1  August  1985  * 

*  Input  Parameters:  w_w,w_l,  dir.  ptr_w  * 

*  Output  Parameters:  none  * 

*  Globa Is  Used:  layer,  space_used  * 

*  Modules  Called:  P1ace_Mlre_Parameters  (recursion)  * 

*  Calling  Modules:  Oef  Hire,  Place_Mire_Parameters,  Get_Mlre,  * 

*  Mod_M1re  ~  * 

*  Function:  Place  the  segments  of  wire  Into  memory  * 

*  POL:  * 

*  If  wire  segment  being  examined  is  empty  * 

*  allocate  memory,  * 

*  place  parameters;  * 

*  else  go  to  next  wire  segment.  * 

*  * 


Place_H1re_Parameters  (w_w,  w_l ,  dir,  ptr_w) 
struct  w1re_parameters  **ptr_w; 


{ 

jf  (*ptr_w  ==  NULL) 

{ 

space_used  =  space_used  +  sizeof  (struct  wire_parameters); 

*ptr_w  =  alloc  (sizeof  (struct  wire_parameters ) ) ; 
(*ptr_w)->next_segment  =  NULL; 

(*ptr_w)->width  =  w_w; 

(*ptr_w)->length  =  w_l ; 

(*ptr_w)->w_Iayer  =  layer; 

(*ptr_w)->direction  =  dir; 

) 

else 

P1ace_H1 re_Parameters  (w_w,  w_l .  dir,  &(*ptr_w)->next_segment) ; 

) 


#ifneed  Oef_Via 

^Jtr*********************************************************************** 
*  * 

*  Hodule  Name;  Def  Via  * 

*  Module  Number;  l73.4  * 

*  Version/Date;  1.0  28  July  1985  * 

*  Input  Parameters;  none  * 

*  Output  Parameters;  none  * 

*  Globals  Used;  layer,  s_v1a,  d_v1a,  p_v1a  * 

*  Modules  Called;  Def_Layer.  Via_Tree,  Get_Num,  Get_0ption  * 

*  Calling  Modules;  Implement  * 

*  Function;  Define  via  parameters  layer  and  x.y  location  * 

*  POL;  Define  Layer;  * 

*  While  not  finished  placing  vlas  * 

*  While  not  finished  current  layer  * 

*  Input  x.y  location  of  via  * 

*  place  via  In  structure;  * 

*  If  want  to  place  vlas  In  another  layer  * 

*  Define  Layer;  * 

*jmr*>lrinnn»r*imr****llr**inr>lf*»»r**ilfinmf*llr**********r;**>lt******************mr***ilrnrim^ 

Def_V1a  {) 

{ 

Int  finished,  f1n1_layer,  x  location.  y_locat1on; 

printf  ( "NnVnXnXnNnXnNnXn  \t\t\t  READY  TO  PLACE  A  VIA  "); 

0ef_Layer  (FALSE);  finished  =  FALSE; 
while  (finished  *=  FALSE) 

( 

whi le  ( layer  ==  'F' ) 

{ 

printf  ("\n  Layer  F  not  valid  for  vlas;  choose  another\n”); 

Oef_Layer  (FALSE); 

} 

flni_layer  =  FALSE; 
while  (finl  layer  ==  FALSE) 

{ 

printf  ("\n\n  Input  via  x  and  y  locat1ons\n\n’’ ) ; 

printf  (”\n\t\t  x  location;  "); 

x_locat1on  =  Get_Mum  (); 

printf  ("\n\n\t\t  y  location:  ”); 

y_location  =  Get_Num  (); 

if  (layer  ==  'S')  Via_Tree  (x_location,  y_location,  gis_via); 
else  if  (layer  ==  '0')  V1a_Tree  (x_location.  y_location,  &d_via); 
else  if  (layer  ==  'P'j  Via_Tree  (x_location,  y_location,  &p_via); 
printf  ("\n\n  Another  via  this  layer  (return  or  N):  "); 
if  (6et_0pt1on  ()  !=  '\n')  f1n1_layer  =  TRUE; 

} 

printf  ("\n\n\n  Another  via  any  layer  (return  or  N);  "); 
if  (Get_0ption  ()  !=  '\n')  finished  *  TRUE; 
else  Def  Layer  (FALSE); 

) 


#endif 


ffifneed  via_Tree 
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*  Module  Maine:  Via_Tree  * 

*  Module  Number:  1.3. 4.1  * 

*  Version/Date:  1.0  28  July  1985  * 

*  Input  Parameters:  v_x,  v _y,  1_vla  ’* 

*  Output  Parameters:  none  * 

*  Globa  Is  Used:  space_used  * 

*  Modules  Called:  Via_Tree  (recursion)  * 

*  Calling  Modules:  Oef_Via,  V1a_Tree,  Get_V1a,  Mod_V1a,  * 

*  Out_W_Segment  * 

*  Function:  Place  via  In  proper  place  by  x  location  * 

*  POL:  * 

*  If  via  location  is  empty  * 

*  then  allocate  space  and  place  x.y  locations  In  structure;  * 

*  else  If  v_x  to  be  placed  <  x  examined  * 

*  then  enter  via  tree  to  the  left; 

*  else  If  v_x  to  be  placed  =  x  examined  * 

*  then  enter  via  tree  to  the  middle;  * 

*  else  if  v_x  to  be  placed  >  x  examined  * 

*  then  enter  via  tree  to  the  right.  * 

ir  4 


V1a_Tree  (v_x,  v _y,  l_v1a) 
struct  via  **1_v1a; 


if  (*1  via  ==  NULL) 

( 

space_used  =  space_used  +  sizeof  (struct  via); 

*l_via  =  alloc  (sizeof  (struct  via)); 

(*l_via )->v_l_t_x  =  (*l_v1a)->v_e_x  =  {♦1_v1a )->v_g_t_x 
{'*l_v1a)->v_x_locat1on  =  v_x; 

(*l_via)->v_y_location  =  v_y; 

) 

el  se 
{ 

if  (v_x  <  (*l_via )->v_x_location) 

Via_Tree  (v_x,  v _y,  4(*l_v1a)->v_l_t_x); 
else  if  (v_x  ==  {*l_via)->v_x_locat1on) 

Via_Tree  (v_x,  v _y,  &(*l_via)->v_e_x); 
else  Tf  (v_x  >  (*l_via)->v_x_location) 

Via_Tree  (v_x,  v _y,  4(*1_v1a)->v_9_t_x); 

} 

) 

Nendi f 


=  MULL; 


IKIfneed  Def_F1ash 


1985 


Module  Name:  Oef_Flash 
Module  Number:  1.3.5 
Verslon/Oate:  1.0  28  July 
Input  Parameters:  none 
Output  Parameters:  none 
Globa Is  Used:  none 
Modules  Called:  none 
Calling  Modules:  Implement 

Function:  Define  a  round  flash  based  on  user  Inputs 
POL:  N/A 


* 

* 

Hr 

Hr 

Hr 

* 

Hr 

Hr 

Hr 

Hr 

Hr 


HrHr*lkHr*HrHrHrHr**HrHri^HrHr*HrHrHrHrHrHrHrHr**Hr:HHrHrHr*HrHr*HrHrHrHrHr1^HrHrHrHrHrHrHrHrHrHrHrHrHrHr*HrHrHrHrHrHr*HrHrHr*HrHrHr  j 


Oef_Flash  () 

1 

printf  (''\n\n  Define  Flash  Is  not  yet  Implemented  \n\n''); 
) 


#end1f 


Oifneed  Print_Work 

yAtUklkWVHHtllt*************************************************************** 

*  Module  Name:  Print_Mork  * 

*  Module  Number:  1.3.6  * 

*  Verslon/Oate:  1.0  28  July  1985  * 

*  Input  Parameters:  none  * 

*  Output  Parameters:  none  * 

*  Globals  Used:  port_ptr,  f_rect,  s_rect,  d_rect,  p_rect,  s_v1a  * 

*  d_v1a,  p_vla,  wire_ptr,  ca11_ptr,  1ter_ptr  * 

*  Modules  Called:  Get_0ption.  Ma1k_P_Tree,  Halk_R_Tree,  * 

*  Malk_H_Tree,  Malk_W1a_Tree,  Malk_I_Tree  * 

*  Calling  Modules:  Implement.  0_lmplement.  M_Implement  * 

*  Function:  Print  the  work  accomplished  * 

*  POL:  N/A  * 


*★*********■*******★*****★*»*★★*★**★*★***★★*************★★»***★*******♦★*/ 
Pr1nt_Work  () 


char  option; 

printf  ("\n\n  Do  you  want  to  see  the  Ports  (ret  or  N):  ”); 

If  (Get_0ptlon  ()  ==  '\n') 

Wa1k_P_Tree  (port_ptr); 

printf  ("\n\n  Do  you  want  to  see  the  rectangles  (ret  or  N):  ”); 
if  (Get  Option  ( )  ==  An' ) 

( 

printf  ("\n\n  First  metal  rectangles  (ret  or  N):"); 
if  (Get_0ption  ()  ==  '\n') 

Halk_R_Tree  (f_rect); 

printf  ("\n\n  Second  m  rectangles  (ret  or  N):"); 
if  (Get_0ption  ()  ==  '\n’) 

Malk_R_Tree  (s_rect); 

printf  ("\n\n  Rectangles  in  Diff  (ret  or  N):’’); 
if  (6et_0ption  ()  ==  An') 

Malk_R_Tree  (d_rect); 

printf  ( "\n\n  Rectangles  in  Poly  (ret  or  N):”); 
if  (Get_0ption  ()  ==  '\n‘) 

Walk_R  Tree  (p_rect); 

1 

printf  ("\n\n  Do  you  want  to  see  the  wires  (ret  or  N):  "); 
if  |Get_0ption  ()  ==  An') 

Walk  W  Tree  (wire  ptr); 


uirv.w^.  #■- v\  w-w'#'-  wvruirjjrjir^'r'*  c.nr^Tr\nrj^’%Wi 


printf  (”\n\n  Do  you  want  to  see  the  vias  (ret  or  N);  "); 
if  (6et_0ptlon  {)  ==  '\n‘) 

( 

printf  ("\n\n  Vias  to  Second  metal  (ret  or  N):  "); 
if  (Get_0ption  ()  ==  An’) 

Halk_Via_Tree  (s_v1a); 

printf  ("\n\n  Vias  to  Diffusion  (ret  or  M):  "); 
if  (Get_0ption  ()  ==  An') 

Malk_Via_Tree  (d_vla); 
printf  ("\n\n  Vlas  to  Poly  (ret  or  M):  "); 
if  (Get_0ption  ()  ==  'Nn') 

Walk  Via_Tree  (p_via); 

) 


printf  ("\n\n  Do  you  want  to  see  the  call  statements  (ret  or  N):  “) 
if  (Get_0ption  ()  ==  '\n') 

Walk_C_Tree  (ca11_ptr); 


printf  ("\n\n  Do  you  want  to  see  the  iterated  statements  (ret  or  H) 
if  (Get_0pt1on  ()  ==  '\n') 

Walk_T_Tree  (iter_ptr); 


printf  ("\n  Hit  return  to  continue:  "); 
while  (getc(O)  !=  '\n'); 

} 


#endif 


If  need  Malk_P_Tree 

^★**************ilr***r**W*******1lr*»*1HHHItHr»***>m:1nmr****>l:****-**-)»-*>lr***>»r»*t»rj»r*Hf)lr 


★ 

* 

* 

Hodule  Name:  Walk_P_Tree 

it 

it 

Hoduie  Number:  1,3. 6.1 

Hr 

it 

Version/Date:  1.0  7  September  1985 

* 

* 

Input  Parameters;  p_ptr 

Hr 

* 

Output  Parameters:  none 

Hr 

* 

Globals  Used:  none 

Hr 

* 

Modules  Called;  Halk_P_Tree  (recursion) 

Hr 

* 

Calling  Modules:  Print_Mork,  Ma1k_P_Tree 

Hr 

Hr 

Function:  Walk  the  port  tree 

it 

Hr 

POL: 

Hr 

* 

While  the  location  is  defined 

* 

Hr 

if  the  port  hasn't  been  deleted 

Hr 

Hr 

print  the  port; 

Hr 

Hr 

Go  to  the  next  location. 

* 

Hr 

* 

<rJHlf**#*<t*<n*********lHlr******llrimr**iHHHIr****t»'*imrjmf***»)lr*>mr*ilr)lr*>»r)lr***Xr)lr>mfimf*)(f*  j 


Walk_P_Tree  {p_ptr) 
struct  Interports  *p_ptr; 


if  (p_ptr  !=  NULL) 

{ 

if  (p  ptr->y  loc  !=  -9999) 

{ 

printf  ("\n  Port;  %s  »c  ",  p_ptr->port_name,  p_ptr->port_layer); 
printf  ("*d,*d\n",  p_ptr->x_loc,  p  ptr->y  loc); 

} 

WalkPTree  (p_ptr->next_port); 


Nendif 


#1fneed  Halk_R_Tree 

^********>»r************J»r*******JHIr****»**<lt**Hr********>lf*************1lr******* 
*  * 

*  Module  Name:  Wa1k_R_Tree  * 

*  Module  Number;  1.3. 6. 2  * 

*  Version/Date:  1.0  28  July  1985  * 

*  Input  Parameters:  rect;  pointer  to  next  rectangel  * 

*  Output  Parameters:  none  * 

*  Global s  Used:  none  * 

*  Modules  Called;  Malk_R_Tree  (recursion)  * 

*  Calling  Modules;  Prlnt_Mork,  Malk_R_Tree  * 

*  Function;  Walk  the  rectangle  tree  given  the  layer  * 

*  POL:  * 

*  If  the  location  Is  defined  * 

*  Walk  the  left  rectangle  structure;  * 

*  If  the  rectangle  hasn't  been  deleted  * 

*  print  the  rectangle;  * 

*  Walk  the  middle  rectangle  structure;  * 

*  Walk  the  right  rectangle  structure.  * 


Walk_R_Tree  (rect) 
struct  rectangle  *rect; 

{ 

if  (rect  !=  NULL) 

( 

Walk_R_Tree  (rect->less_than_x); 
if  (rect->he1ght  !=  0  ||  rect->length  !=  0) 

{ 

printf("\nHe1ght=  *d,  length*  »d,  ",rect->he1ght,rect->length); 
pr1ntf("x=  *d,  y=*d\n" ,rect->x  location, rect->y  location); 

} 

Walk_R_Tree  (rect->equals_x); 

Wal k_R_Tree  ( rect->greater_than_x ) ; 

) 

} 


#endif 


#ifnee<l  Ma1k_W_Tree 

#  * 


* 

* 

* 
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Module  Name:  Malk_W_Tree 
Module  Number:  1.3. 6. 3 
Version/Date:  1.0  28  July  1985 

Input  Parameters:  ptr 
Output  Parameters:  none 
Global s  Used:  none 

Modules  Called:  Segment_Tree.  Walk_M_Tree  (recursion) 
Calling  Modules:  Pr1nt_Work.  Malk_M_Tree 
Function:  Walk  the  wire  tree  given  the  layer 
POL: 

If  the  location  Is  defined 
Ualk  the  left  wire  tree; 
if  the  wire  has  segments  defined 
Print  the  wire  start. 

Print  the  wire  segments; 

Walk  the  middle  wire  tree; 

Walk  the  right  wire  tree. 


•k 

* 

* 

* 

* 

* 
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k 

k 
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Walk_W_Tree  (ptr) 
struct  wire  *ptr; 

{ 

if  (ptr  !=  NULL) 

( 

Wa1k_W_Tree  (ptr->w_l_t_x); 
if  (ptr->w_param  !=  NULL) 

( 

printf("\n  Wire  x.y  =  *d,*d'',ptr->w_x_locat1on,ptr->w_y_location); 
Segment_Tree  (0,  '  ptr->w_param) ; 

) 

WalkWTree  (ptr->w_e_x); 

WaIk_W_Tree  (ptr->w_g_t_x ) ; 

} 


Nendlf 


tflfneed  Seqtnent_Tree 

^irit*i[ifitic-kic1titititiriti[itit*ititfticicicicitititititi[i(ic-kifftiticitit'ki('k'kitiitiicit'k'kir*'kicicitfcit*itft’kiti(iticfiiiiritit 
*  * 

*  Module  Name:  Segment_Tree  * 

*  Module  Number;  1.3. 6. 3.1  * 

*  Version/Date;  1.0  28  July  1985  * 

*  Input  Parameters:  p_w1dth,  p_1ayer,  seg  * 

*  Output  Parameters:  none  * 

*  Global s  Used:  none  * 

*  Modules  Called:  Segment_Tree  (recursion)  * 

*  Calling  Modules:  Halk_M_Tree.  Segment_Tree,  Mod_Hire  * 

*  Function;  Get  the  wires*  segments  * 

*  POL :  * 

*  If  the  location  is  defined  * 

*  If  this  segment  Is  on  a  different  layer  * 

*  print  the  new  layer;  * 

*  If  this  segment  has  a  different  width  * 

*  print  the  ne  width;  * 

*  Go  to  the  next  wire  segment.  * 


ii 
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Segment_lree  (p_wldth,  p_layer,  seg) 
struct  wire_parameters  *seg; 


IT  (seg  !=  NULL) 
t 


IT  (P-layer  !=  seg-;>w_layer) 
prIntT  (“  %c'‘,seg->w_iayer); 

IT  (p_w1dth  !=  seg->w1dth) 
printT  ( ••  M  »d'',  seg->w1dth); 
printT  ("  Xc  Xd",  seg->d1 rectlon ,  seg->length ) ; 

Segment_lree  (seg->w1dth,  seg->w_layer ,  seg->next_segment); 
} 


‘v'vS 
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#endif 
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«ifneed  Wall(_Via_Tree 

Jicicitit*'kitiiititititif^iti(icitiei(itiri[icit'kiei(lriritif1ti(itititici(icitit[iticici(i(ic'k'kicicic’kic'k'k'ki(iciei(irir'kitit'k'kitit'k 


* 

it 

* 

Module  Marne;  Malk_Via_Tree 

it 

* 

Module  Number;  1.3. 6. 4 

it 

* 

Version/Oate;  1.0  28  July  1985 

it 

it 

Input  Parameters;  1_via 

it 

it 

Output  Parameters;  none 

it 

it 

Globa  Is  Used;  none 

it 

it 

Modules  Called;  Malk_Via_Tree  (recursion) 

it 

it 

Calling  Modules;  Print_Mork.  Malk_Via_Tree 

it 

it 

Function;  traverse  the  via  tree  give  the  layer 

it 

* 

POL; 

it 

* 

If  the  location  is  defined 

it 

* 

Walk  the  left  via  tree; 

it 

* 

if  the  via  has  not  been  deleted 

* 

★ 

print  the  via; 

* 

* 

Walk  the  middle  via  tree; 

* 

it 

Walk  the  right  via  tree; 

* 

it 

♦ 

Malk_V1a_Tree  (l_via) 
struct  rectangle  *1  via; 

{ 

If  (1_via  !*  HULL) 

{ 

Wallc_Via_Tree  { 1_v1a->v_1_t_x ) ; 
if  ( l_via->v_y_location  !=  -9999) 

printf { "x=  %d,  y=*d\n\n'' , l_via->v_x_1ocation, l_via->v_y_location) ; 
Walk_Via_Tree  ( 1_via->v_e_x) ; 

WaIk_Via_Tree  (1  via->v  g  t_x); 

} 


#endi  f 


#ifneed  Walk_C_Tree 
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Module  Name:  Wallc_C_Tree 

Module  Number:  1.3. 6. 5 

Version/Date:  1.0  21  Aug  1985 

Input  Parameters:  ptr 

Output  Parameters:  none 

Global s  Used:  c_port_ptr 

Modules  Called:  Walk_C_Tree  (recursion) 

Calling  Modules:  Print_Work,  Wa1k_C_Tree 
Function:  traverse  the  call  statements  tree 
POL: 

If  the  location  is  defined 
Walk  the  left  call  tree; 

If  the  call  hasn't  been  deleted 
print  the  call  statement, 
while  there  are  more  ports  defined 

if  the  port  hasn't  been  deleted,  print  the  port; 
Walk  the  middle  call  tree; 

Walk  the  right  call  tree. 


it 

* 

* 

* 

it 

* 

It 

it 

it 

it 

it 

it 

it 

it 

it 

* 

* 

it 
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Walk_C_Tree  (ptr) 

struct  cal l_statement  *ptr; 

{ 

if  (ptr  !=  NULL) 

{ 

Walk_C_Tree  (ptr->l_t_name) ; 
if  (ptr->tran  y  !=  -9999) 

{ 

printf  ("\nC  Xs  Xd",  ptr->cel Iname,  ptr->c1fnum); 
printf  ("  T  Xd.Xd"  ,ptr->tran_x,  ptr->tran_y ) ; 
if  (ptr->mir_x  ==  TRUE)  printf  ("  Flip  UD”); 
if  (ptr->mir_y  ==  TRUE)  printf  ("  Flip  LR"); 
if  (ptr->rot_x  !=  '  ') 

{ 

printf  ( "  R  Xc 
if  (ptr->rot_x 
) 

c_port_ptr  =  ptr->c_ports; 
while  (c_port_ptr  !=  NULL) 


ptr->rot_x ) ; 

T)  printf  ("2"); 


if  (c_port_ptr->port_name(OJ  !=  '-') 
printf  ( "\n\t  Port  Xs  ",  c_port_ptr->port_name ) ; 
cportptr  =  c_port_ptr->next_name; 

} 

} 

Walk_C_Tree  ( ptr->e_name ) ; 

Walk_C_Tree  ( ptr->g_t_name ) ; 

} 


#ifneed  Ma1k_I_Tree 

★  ^ 

*  Module  Name:  Walk_I_Tree  * 

*  Module  Number:  1.3. 6. 6  * 

*  Version/Date:  1.0  21  Aug  1985  * 

*  Input  Parameters:  ptr  * 

*  Output  Parameters:  none  * 

*  Globa  Is  Used:  c_port_ptr  8 

*  Modules  Called:  Walk_I_Tree  (recursion)  * 

*  Calling  Modules:  Pr1nt_Work.  Malk_I_Tree  * 

*  Function:  traverse  the  Iterate  statement  tree  * 

*  POL:  * 

*  If  the  location  is  defined  * 

*  Walk  the  left  Iterate  tree;  * 

*  If  the  iterate  hasn't  been  deleted  * 

*  print  the  iterate  statement,  * 

*  while  there  are  more  ports  defined  print  the  port;  * 

*  Walk  the  middle  Iterate  tree;  * 

*  Walk  the  right  Iterate  tree.  * 

llr***********imr****ilHHHIr)»r******HrJlr*>HHIrllrHrHt**Jlr*>lfllr*****^**************W******llr  j 

Wa1k_I_Tree  (ptr) 

struct  1ter_statement  *ptr; 

{ 

if  (ptr  !=  NULL) 

{ 

Walk  I_Tree  (ptr->l_t_c1fnum) ; 

If  (ptr->x  iters  !»  -9999) 

{ 

printf  ("\nlterate  *s  *d",  ptr->ce) Iname,  ptr->cifnum) ; 

printf  ("  %dxXd  ",  ptr->x_iters,  ptr->y_1ters); 

printf  ("pitch  %d,Xd",  ptr->x_pitch,  ptr->y_p1tch) ; 

printf  ("  start  Xd.Xd"  ,ptr->1_cal l->tran_x,  ptr->i_cal 1 ->tran _y): 

if  (ptr->i_call->mir_x  ==  TRUE)  printf  (”  Flip  UD"); 

If  (ptr->i_ca1 1 ->mir_y  ==  TRUE)  printf  ("  Flip  LR"); 
if  ( ptr->i_cal 1 ->rot_x  !=  '  ’) 

{ 

printf  ("  R  Xc",  ptr->i_cal l->rot_x); 
if  (ptr->i_cal  1 ->rot_x  ==  T)  printf  {"2"); 

) 

c_port_ptr  =  ptr->1_ca1 1 ->c_ports; 
while  {c_port_ptr  !=  NULL) 

( 

if  (c_port_ptr->port_name['’l  !=  ’-') 
printf  ("\n\t  Port  Xs  ",  c_port_ptr->port_name ) ; 
c_port_ptr  =  c_port  ptr->next_name; 

} 

} 

Walk_I_Tree  (ptr->e_c1fnum) ; 

Wa1k_I_Tree  (ptr->g_t_cifnum); 

}> 

Nendif 


#ifneed  Save_Cell 

^**»****i»r***i»r****Jlr****3(r*^lr*********T*r*Jlr**^lf*ilr******************llf1lrT*********** 
'k  k 

*  Module  Name:  Save_Cell  * 

*  Module  Number:  1.3.7  * 

*  Version/Oate:  1.0  29  August  1985  * 

*  Input  Parameters:  filename,  cell  name  * 

*  Output  Parameters:  none  * 

*  Globals  Used:  port_ptr,  f_rect.  s_rect,  d_rect,  p_rect,  s_vla  * 

*  d_via,  p_via,  wire_ptr,  can_ptr,  1ter_ptr  * 

*  Modules  Called:  Store_Ptrs.  SAVECELL  (7.0)  * 

*  Calling  Modules:  Implement.  0_lmplement.  M_Imp1ement  * 

*  Function:  Call  SAVECEll  subprogram  after  storing  needed  Info  * 

*  POL:  * 

*  Store  the  filename; 

*  Store  the  cell  name;  * 

*  Store  the  pointers  to  the  structures;  * 

*  Execute  SAVECELL.  * 


Jr**********************************************************************'*  i 


Save_Ce11  (filename,  cell  name) 
char  ^filename, 

*cel 1  name; 

{ 

Int  1.  j; 

char  a_ptr_argv(801 ; 

i  *  0; 

while  ((a_ptr_argv(11  =  f11ename{1])  !=  '\0* )  ++1; 
a_ptr  argvli]  =  '  ' ; 

j  =  oT  ++1; 

while  ( (a_ptr_argv(i I  =  cel  1  name (j++l )  !=  '\0')  ++1; 
a_ptr_argv(il  =  '  ’; 

Store_Ptrs  (port_ptr.  a_ptr_argv,  &1); 

Store_Ptrs  (f_rect,  a_ptr_argv,  &1); 

Store_Ptrs  (s_rect,  a_ptr_argv,  41); 

Store_Ptrs  (d_rect,  a_ptr_argv,  41); 

Store_Ptrs  (p_rect,  a_ptr_argv,  41); 

StorePtrs  (s_v1a,  a_ptr_argv.  41); 

Store_Ptrs  (d_via,  a_ptr_argv.  41); 

Store_Ptrs  (p_via,  a_ptr_argv,  41); 

Store_Ptrs  (w1re_ptr,  a_ptr_argv,  41); 

Store_Ptrs  (cal1_ptr,  a_ptr_argv.  41); 

Store_Ptrs  (1ter_ptr,  a_ptr_argv,  41); 
exec  ("savecell",  a_ptr_argv); 

) 


Nendlf 


#1fneed  Store_Ptrs 

^★★★imt**********************************'********************************* 


* 

it 

* 

Nodule  Name;  Store_Ptrs 

it 

* 

Nodule  Number;  1.3. 7.1 

* 

* 

Version/Date;  1.0  9  September  1985 

* 

* 

Input  Parameters;  ptr,  a_ptr_argv.  1 

* 

* 

Output  Parameters;  a_ptr_argv,  1 

* 

* 

Global s  Used;  none 

* 

* 

Nodules  Called; 

* 

it 

Calling  Nodules;  Save_Cen 

★ 

it 

Function;  Store  the  pointers  In  a  string 

* 

it 

POL; 

★ 

* 

Convert  the  pointer  to  an  ASCII  string; 

* 

* 

Add  It  to  the  existing  string  of  arguments; 

* 

it 

Insert  a  blank  as  a  separator  between  arguments. 

* 

*  * 
***<r*1lr****<tillr***f***;»*llf*lk***ilHHt**r*llf****llr**********<IHr*i****************1lf**llr*y 


Store_Ptrs  (ptr,  a_ptr_argv,  i) 

char  *a_ptr_argv; 

int  *1; 

( 

int  j; 

char  a_nuin  [7); 

itoa  (ptr,  a_num); 
j  =  0; 

++*1 ; 

while  ( (a_ptr_argv[*1 ]  =  a_numlj++l )  !=  ’\0’ ) 
++*i ; 

a_ptr_argv[*1 1  =  ‘  ; 

} 


#end1f 
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*  * 


* 

* 

* 

* 

* 

* 
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* 

★ 

* 
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Program  Name:  DPM.C  * 

Version/Date:  1.0  20  August  1985  * 

Function:  This  subprogram  to  MOCLL.C  Is  used  to  manipulate  * 
already  existing  basic  cells  to  arrange  them  Into  * 

a  circuit.  It  allows  the  user  to  place  a  cell  In  * 

position,  move  a  cell  from  one  location  to  another,  * 
or  delete  a  cell  from  the  circuit.  * 

Include  Files  Needed:  MOCLL.H  (which  Includes  tprlntf.c  * 

exec.c,  and  all  global  variables  needed  In  the  * 

MOCLL  system),  DPMLIB.LIB,  CRE8LIB.LIB,  SAVELIB.LIB,  * 
and  STOLIB.C.  * 

Program  Hierarchy:  * 

* 


2.0  0PM  Main 

I 

1 - 1.1*  Name_Cell 

I 

I - 2.1  Get  Cell 

I  I 

I  I - 2.1.1  In_Fne 


* 

Hr 

* 

Hr 

Hr 

Hr 

Hr 

Hr 


* 

Hr 

Hr 

Hr 

Hr 


-  2.1.2 


GetJPort 

—  2.1,1*  In  File 

—  1.3. 1.2*  Get^Num 

—  1 .3. 1 ,3*  Port  Tree 


Hr 

Hr 

Hr 

Hr 

Hr 


Hr 

* 

★ 

it 

Hr 


2.1.3 


Get  Rect 

—  2.1.1*  In  File 

—  1.3. 1.2*  Get_Num 

—  1.3.2. 1*  Rect  Tree 


* 

Hr 

Hr 

Hr 

Hr 


Hr 

Hr 

-* 

Hr 

Hr 

Hr 


2 


1,4  Get^Wire 

I - 2.1,1*  In_File 

I - 1,3. 1.2*  Get^Num 

I - 1.3. 3. I*  S^WIre^Tree 

I - 1,3. 3, 3*  Place  Wire  Parameters 


Hr 

Hr 

Hr 

Hr 

★ 

Hr 


★ 

it 

★ 

it 

It 


2.1.5 


Get  Via 


it 


- 2.1.1*  Injile  * 

-  1.3. 1.2*  Get_Num  * 

-  1.3. 4.1*  Vla^Tree  * 

Hr 


Hr 

-* 

Hr 

Hr 

* 

* 

Hr 

* 


2.1,6 


Get^Call 

---  2.1,1*  In_Fne 

—  1.3. 1.2*  Get^Nurr 

—  2. 1.6. I  Get  C_Parameters 

I - 1.3. 1.2*  Get_Num 

2. 3. 1.2*  Call_Tree 

2. 3. 2. 3.1*  Port  Call  Place 


it 

Hr 

Hr 

Hr 

Hr 

* 

it 

Hr 
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1 - 2.1.7  Get  Iter 

1 - 2.1.1*  In  File 

* 

1 - 1.3. 1.2*  6et_Num 

* 

1 - 2. 1.6.1*  Get  C_Parameters 

Mr 

1 - 2. 3. 3. 2*  Iter  Tree 

Mr 

1 - 2. 3. 1.2*  Call  Tree 

★ 

1 - 2. 3. 1.3.1*  Port_Call_Place 

* 

j - 

1.2,1*  Get_0ption 

Mr 

Mr 

1 - 

2.2  0PM_Menu 

Mr 

1 - 1.2.1*  Get_0ption 

Mr 

Mr 

1 - 

2.3  0_lmplement 

1 

Mr 

Mr 

1 - 1.1*  Name_Cel1 

Mr 

I 

Mr 

1 - 7.1*  Det  Cifnum 

Mr 

1 

Mr 

1 - 1.2.1*  Get_0ption 

Mr 

Mr 

I - 2,3,1  P1ace_Call  * 

I  I - 2.3, 1.1  Can_Parameters  * 

f  I  I  I - 1.3, 1.2*  Get_Mum  * 

I  I  I - 1.2,1*  Get_0pt1on  * 

r  1  1 - 2,3.1.2r  Call.Tree  * 

'  I  1 - 2. 3. 1.3  C_Port_Hames  * 

r  I  I  I - 1,2.1*  Get_0pt1on  * 

r  1  I  I - 2.3.1.3.1r  Port_Can_P1ace* 

f  I  I - 1.2.1*  Get_Optlon  * 

f  1  * 

►  I - 2.3.2r  Mod_Can  * 

^  I  I - 1.2.1*  Get_0pt1on  * 

ir  1  I - 2. 3. 1.1*  Cal l_Parameters  * 

f  1  1 - 2. 3. 1.3*  C_Port_Mames  * 

‘  ‘  : 

►  I - 2.3.3  Iterate_Cal1  * 

►  1  I - 2. 3. 1.1*  Call_Parameters  * 

t  I  I - 2.3.3. 1  Iter  Parameters  * 

It  I  I  I - i73.1.3*  Get_Num  * 

•r  1  I - 2.3.3.2r  Iter_Tree  * 

»  I  1 - 2.3.1.2*  Call.Tree  * 

k  I  I - 2.3. 1.3*  C_Port_Names  * 

'  '  ‘  : 

k  1 - 2.3.4r  Mod_lter 

*  I  I - 1.2.1*  Get_Option  * 

*  I  I - 2.3.3. 1*  lter_Parameters  * 

*  I  1 - 2. 3. 1.1*  Cal 1_Parameters  * 

*  I  I - 2.3. 1.3*  C_Port_Names  * 

*  I - 1.3.6*  Print  Work  * 

*  1 - 1.3.7*  Save.Cell  * 

*JI’**’*>lr*»)H«r*#)Hmr**J»r**JH«-****ir****#****************************************/ 


#inc1ude  “mdcll.h" 

^Jlr*********************************************************************** 

*  if 

*  Module  Name:  Main  * 

*  Module  Number;  2.0  * 

*  Version/Oate;  1.0  21  August  1985  * 

*  Input  Parameters;  none  * 

*  Output  Parameters:  none  * 

*  Globa Is  Used:  none  * 

*  Modules  Called:  6et_Cen,  OPH^Menu.  0_Imp1ement,  * 

*  Name_Ce11,  Get_0pt1on  * 

*  Calling  Modules;  MOCLL  program  * 

*  Function:  Delete.  Place,  or  Hove  a  cell  In  a  circuit  * 

*  POL:  * 

*  Get  the  name  of  the  parent  cel  1 ;  * 

*  If  the  parent  cell  is  on  disk  * 

*  Get  the  cell;  * 

*  else  If  not  a  new  parent  cell  * 

*  Parent  name  not  valid  so  quit;  * 

*  If  parent  name  Is  valid  * 

*  While  option  from  0PM  menu  Is  other  than  quit  * 

*  Implement  the  desired  option.  * 


Or*********************************************************************** i 


main  ( ) 

{ 

char  option, 

p_cel 1 name(15] , 
p_f i 1enameil2i ; 

Int  on_d1sk; 

option  =  '  ' ; 

printf  ( "\n\n\n\n\n\n\t  REAOY  TO  DELETE,  PLACE,  or  MOVE  A  CELL\n\n\n" ) ; 
printf  ("\n\n\n\n\n  Input  the  name  of  the  parent  cell:  ”); 

Name_Cell  (&on_d1sk,  p_f11ename,  p_cellname); 

If  (on_d1sk  ==  TRUE) 

Get_Cell  (p_f11ename,  p_cel1name); 
el  se 
{ 

printf  ("\n  Do  you  want  a  new  parent  cell  by  the  name  %s'' ,p_cel  Iname) ; 
printf  {"  (return  or  N):  "); 
if  (Get_0ption  ()  !=  '\n')  option  =  'Q'; 

} 

if  (option  !=  *Q') 

while  ((option  =  0PM_Menu  (p_cellname))  !=  'Q') 

D_Implement  (option,  p_filename,  p_ce1 Iname); 

} 

#1nc1ude  “dpml ib. 1 1b" 

Ninclude  "cre81 ib. 1 ib" 

Ninclude  "savel ib. 1 ib" 

^include  "stdlib.c" 


tfifneed  Get_Ce11 

ft  * 

*  Module  Marne:  6et_Cen  * 

*  Module  Number:  2.1  * 

*  Verslon/Oate:  1.0  21  August  1985  * 

*  Input  Parameters:  filename,  cellname  * 

*  Output  Parameters:  none  * 

*  Global s  Used:  none  * 

*  Modules  Called:  In_Flle.  Get_Rect.  Get_H1re,  Get_via.  * 

*  Get_Port,  Get_Call,  Get  Iter  * 

*  Calling  Modules:  0PM  Main.  MODIFY  Main'  * 

*  Function:  Get  the  cell  from  disk  to  main  memory  * 

*  POL:  * 

*  if  file  available  on  disk  * 

*  while  not  finished  reading  * 

*  if  port  definition  start  then  Get  Ports  * 

*  else  if  rectangle  start  then  Get  Rectangle  * 

*  else  if  wire  start  then  Get  Wire  * 

*  else  if  via  start  then  Get  Via  * 

*  else  if  call  start  then  Get  Call  * 

»  else  if  iterate  start  then  Get  Iter.  * 

*  * 
*  '**nt*****iir**<t********tit***************ntinif**w*imr**i******innnnit***<t**winr*** j 

Get_Ce11  (filename,  cellname) 

char  ^filename, 

*cel Iname; 

{ 

int  f inished_reading; 

char  stringlSOl; 

FILE  *fopen(),  *fp; 

fp  =  fopen  (filename,  "r"); 
if  (fp  !=  NULL) 

{ 

printf  ("\n  Cell  *s  now  being  read  into  memory  \n",  cellname); 

f inished_reading  =  FALSE; 

while  (f inished_reading  ==  FALSE) 

{ 

In_File  (fp,  'Xn',  string); 
printf  ("»s\n",  string); 


if  (str1ng[01  ==  '(•) 

{ 

if  (string[ll  ==  'S'  &&  stringt21  = 

{ 

if  (stringl?)  ==  'P') 

Get_Port  (fp,  string); 
else  if  (string!?]  =»  'R') 
Get_Rect  (fp,  string); 
else  if  (string!?!  ==  *W*) 
Get_H1re  (fp.  string); 
else  if  (string!?!  ==  'V) 

Get_Via  (fp,  string); 
else  if  (string!?!  *«  'C') 
Get_Call  (fp.  string); 
else  Tf  (string!?!  ==  '!') 
Get_Iter  (fp.  string); 

) 

} 

else  if  (string(0!  ==  'E') 
f inished_reading  =  TRUE; 

} 

fclose  (fp); 

} 


#endif 


=  'T'  &&  stringO!  ==  'A* ) 


#lfneed  In_Fne 

it  * 

*  Hodule  Marne;  In_F11e  * 

*  Hodule  Number:  2.1.1  * 

*  Version/Date:  1.0  11  August  1985  * 

*  Input  Parameters:  fp,  flnd_char,  string  * 

*  Output  Parameters:  none  * 

*  Globals  Used:  none  * 

*  Modules  Called;  none  * 

*  Calling  Modules;  Get_Cell,  Get_Rect,  Get_M1re,  Get_V1a.  * 

*  Get_Port.  6et_Call.  Get_Iter,  PRIPLO  Main,  FINALIZE  * 

*  Main,  Process_Cal 1 ,  Format_Clf  * 

*  Function;  Read  from  disk  until  find_char  * 

*  POL :  * 

While  Input  character  is  not  end  of  file  or  searched  for  char  * 

*  Add  the  character  to  the  string  of  Input  characters.  * 

*  * 

In_File  (fp,  f1nd_char,  string) 

register  FILE  *fp; 
register  char  f1nd_char; 
register  char  *strTng; 


register  char  c; 
register  int  i; 


while  ((c  =  getc(fp))  !=  EOF  &&  c 
string[i++]  =  c; 
stringlil  =  '\0'; 

} 

Nendif 


!=  f1nd_char) 


#1fneed  Get_Port 


★ 


* 


Module  Name:  Get_Port 

Module  Number:  2.1.2 

Version/Date:  1.0  9  September  1985 

Input  Parameters:  fp.  string 

Output  Parameters:  none 

Globa  Is  Used:  layer,  port_ptr 

Modules  Called:  In_F11e,  6et_Num,  Port_Tree 

Calling  Modules:  Get_Cell 

Function:  Read  ports  from  disk  Into  main  memory 
POL: 

While  not  finished  Inputting  ports  from  disk 
Get  a  string; 

If  the  Input  string  defines  a  port 
Get  the  port  parameters. 

Place  the  port  parameters  In  the  port  tree; 
else  If  the  string  marks  the  end  of  the  ports 
Set  finished  to  true. 


■k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 


kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk j 

Get  Port  (fp,  string) 

FILE  *fp; 

char  ^string; 

{ 

int  finished,  p_x,  p_y; 

char  portname  [15); 

finished  =  FALSE; 
while  (finished  ==  FALSE) 

In_Fi le  (fp,  '  ‘ ,  string) ; 

if  (string  [0]  ==  '9'  &&  string  (I)  ==  '4') 

In_F11e  (fp.  '  portname); 

p_x  =  Get_Num  (fp); 

p_y  =  Get_Num  (tp); 

getc(tp); 

layer  =  getclTp); 

if  ( layer  ==  'M'  ) 

1 

if  (getc(fp)  *=  '2')  layer  =  'S’; 
else  1 ayer  =  ' F '  ; 

) 

InFile  (fp,  '\n',  string); 

PortTree  (portname,  p_x,  p_y,  &port_ptr); 

) 

else  if  (string(O)  ==  '('  &&  string  11]  ==  'E') 
finished  =  TRUE; 


#end1f 
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#1fneed  Get_Rect 

y ************************************************************************ 


*  Module  Name;  Get_Rect  * 

*  Module  Number;  2.1.3  * 

*  Version/Date;  1.0  11  August  1985  ’• 

*  Input  Parameters;  fp,  string  * 

*  Output  Parameters;  none  ” 

*  Global s  Used;  layer,  f_rect.  s_rect,  d_rect,  p_rect  * 

*  Modules  Called;  In_F11e,  Get_Num,  Rect_Tree  * 

*  Calling  Modules;  Get_Cell  ^ 

*  Function;  Read  rectangles  from  disk  into  main  memory  * 

*  POL;  ^ 

*  While  not  finished  getting  rectangles  * 

*  If  the  next  input  is  the  end  of  rectangles  marker  ” 

*  Set  finished  to  true; 

*  else  if  the  next  input  is  a  layer  definition  * 

*  Set  the  layer  being  defined;  * 

*  else  if  the  next  input  defines  a  rectangle  * 

*  Get  the  rectangle  parameters,  * 

*  Place  the  rectangle  in  memory  based  on  layer.  * 

*•*»»★****###★********  j 

Get_Rect  (fp,  string) 

FILE  *fp; 
char  ‘string; 

{ 

int  rect_finished,  r_h,  r_l ,  r_x,  r_y; 

rect_f inished  =  FALSE; 

while  (rect_finished  ==  FALSE) 

(switch  (getc(fp)) 

( 


case  ‘L' 


case  'B' 


In_File  (fp,  '\n',  string); 

if  (string(01==’E'  &&  stringlll==’N'  &&  stringl2]==‘D' ) 
rectf inished  =  TRUE; 
break ; 

In_File  (fp,  '\n’,  string); 

if  (string(21  ==  ’P' )  layer  =  ‘P* ; 

else  if  (string(21  ==  '0')  layer  =  'O'; 

else  if  (string(2i  ==  'M'  W  string[31  ==  '2')  layer  =  'S'; 

else  if  (string(21  ==  'M')  layer  =  'F'; 

break ; 

getc(fp); 

r_h  =  Get_Num  (fp);  r_l  =  Get_Num  (fp); 
r_x  =  Get_Num  (fp)  -  r_l/2;  r_y  =  Get_Num  (fp)  -  r_h/2; 
if  (layer  ==  'F')  Rect_Tree  (r_h,r_l ,r_x,r_y,&f_rect); 

else  if  (layer  ==  'S’)  RectTree  (r_h,r_l .r_x,r_y,&s_rect); 

else  if  (layer  ==  ’O’)  Rect_Tree  (r_h,r_l ,r_x,r_y,&d_rect); 

else  if  (layer  ==  'P')  Rect_Tree  (r_h,r_l ,r_x,r_y,&p_rect); 


Nendif 


#1fneed  Get_Wire 

y*********>k*l>**lKr*<Hlt*****l»******'«lr***iKrllf1lt*Hr*>mrilr*Hr#*iH>:*>mr***i»>lr>mr*>Hlr**)»r***#* 
*  * 


★ 

Module  Name:  Get_Hire 

★ 

* 

Module  Number:  2.1.4 

k 

* 

Version/Oate:  1.0  11  August  1985 

it 

■k 

Input  Parameters:  fp,  string 

it 

* 

Output  Parameters:  none 

it 

* 

Globals  Used:  layer,  wire_ptr.  seg_ptr 

it 

* 

Modules  Called:  In_File,  Get_Mum,  S_Mire_Tree, 

it 

* 

PI ace_Mi re_Parameters 

it 

* 

Calling  Modules:  Get_Cell 

it 

* 

Function:  Read  wires  from  disk  into  main  memory 

it 

★ 

POL: 

k 

* 

While  not  finished  reading  wires 

k 

it 

If  the  next  input  is  an  end  of  wire  marker 

k 

* 

Set  finished  to  true; 

k 

* 

else  if  the  next  input  defines  a  wire 

k 

it 

Get  the  starting  x,y  location. 

k 

it 

Start  the  wire  in  memory. 

k 

it 

While  there  are  more  segments 

k 

it 

Get  the  segment  parameters. 

k 

* 

it 

Place  the  parameters  in  the  segment  tree. 

k 

k 

*******<t***********************'*****llt*********<t*****llf**r»'*»*****»r**»*****  j 


6et_Hire  (fp. string) 

FILE  *fp; 

char  ^string; 

{ 

int  wire_f ini  shed, 

w_x, 

width, 
length; 
char  c, 

direction; 

wi ref i ni shed  =  FALSE; 
while  (wire_f ini  shed  ==  FALSE) 

{ 

if  ((c  =  getc(fp))  ==  '( '  ) 

{ 

In_Fl le  (fp,  ■  ' ,  string); 

if  (stringtO)  ==  'E'  &&  strlng(l)  ==  'M'  &&  string[21  ==  ‘D’) 
{ 

In_F11e  (fp,  '\n',  string); 
wire  finished  =  TRUE; 


else  if  (strinqtO)  ==  ‘W‘  &&  strlngflj  ==  ’i’) 

{ 

w_x  =  Get_Num  (fp); 
w_y  =  Get_Mum  (fp); 

S_Wire_Tree  (w_x,w_y,&wire_ptr); 
while  {(c  =  getc(fp))  !=  ‘ ) 
switch  (c) 

{ 

case  'F':  case  ‘S':  case  ‘O':  case  'P':  layer  =  c;  break 
case  'W‘:  width  =  Get_Mum  (fp);  break; 
case  'b':  case  ‘f:  case  ‘u‘:  case  ‘d': 

direction  =  c;  length  =  Get_Nuin  (fp); 
P1ace_Wire_Parameters  (width, length, 

direction , seg_ptr ) ; 

) 

} 

else  InFile  (fp,  '\n',  string); 

} 

} 

} 

«endif 


#ifneed  6et_V1a 

*  * 

*  Module  Name:  Get  Via  * 

*  Module  Number;  2.1.5  * 

*  Version/Date:  1.0  11  August  1985  * 

*  Input  Parameters:  fp,  string  * 

*  Output  Parameters:  none  * 

*  Globa  Is  Used;  layer,  s_v1a,  p_v1a.  dvia  * 

*  Modules  Called:  In_Fi1e.  Get_Mum.  V1a_Tree  * 

*  Calling  Modules;  Get_Cell  * 

*  Function;  Read  vlas  from  disk  into  main  memory  * 

*  POL:  * 

*  While  not  finished  reading  vias  * 

*  If  next  Input  Is  an  end  of  via  marker  * 

*  Set  finished  to  true;  * 

*  else  If  next  Input  Is  the  start  of  a  new  layer  of  vias  * 

*  While  more  vias  this  layer  * 

*  Get  via  parameters.  * 

*  Place  parameters  In  via  tree  by  layer.  * 


Get_V1a  (fp.  string) 


FILE 

»fp; 

char 

*str1 ng; 

{ 

int 

viaf inished, 
size, 

v_x. 

v-y; 

char 

c ; 

viafinlshed  =  FALSE; 
while  { viaf 1 ni shed  ==  FALSE) 

{ 

1f  ({c  =  getc(fp))  ==  ■(•) 

( 

InFile  (fp,  '\n',  string); 

if  (string[0]  ==  'E'  &&  string(l)  ==  'N'  &&  string[21  ==  '0') 
viafinished  =  TRUE; 

else  if  (string[81  ==  'S'  ||  string(8)  ==  'O'  ||  string[8)  == 
I 

layer  =  string[81 ; 


■P') 


while  ((c  =  getc(fp))  !=  ’( ’ ) 

{ 

If  (c  =-  ’L') 

In_File  (fp.  '\n',  string); 
else  if  (c  ==  ‘B* ) 

{ 

getc(fp); 

Get_Nuffl  (fp); 

size  =  Get_Mum  (fp); 

v_x  =  Get_Num  (fp)  -  size/2; 

vly  =  Get  Nuffl  (fp)  -  size/2; 

if  (layer  ==  ’S‘) 

Via_Tree  (v_x.  v _y.  &s_via) 
else  if  (layer  ==  *0’ ) 

Via_Tree  (v_x.  v _y.  &d_via) 
else  if  (layer  ==  ‘P* ) 

Via_Tree  (v_x,  v _y.  &p_via) 

) 

> 

} 

else  In  File  (fp.  'Nn'.  string); 

) 

} 

#endif 


#ifneed  Get_Call 

Hr  * 

*  Module  Name:  6et_Call  * 

*  Module  Number:  2.1.6  * 

*  Version/Date:  1.0  21  August  1985  * 

*  Input  Parameters:  fp,  string  * 

*  Output  Parameters:  none  * 

*  Globa Is  Used:  call_ptr.  c_port_ptr  * 

*  Modules  Called:  In_F11e.  Get_Mum.  Call_Tree,  Get_C_Parameters  * 

*  Port_Call_Place  * 

*  Calling  Modules:  Get_Cell,  FINALIZE  Main  * 

*  Function:  Read  calls  from  disk  Into  main  memory  * 

*  POL:  * 

*  While  not  finished  getting  call  statements  * 

*  If  next  input  is  end  of  call  marker  * 

*  Set  finished  to  false;  * 

*  else  if  next  input  Is  a  call  statement  * 

*  Get  call  parameters.  * 

*  Place  parameters  In  call  tree  structure;  * 

*  else  If  next  input  Is  a  portname  * 

*  Get  the  portname,  * 

*  Place  the  port  with  the  call.  * 

*  * 
**HtHr*******Hr*Hr*****Hr*HrHr**Hr******W**WHt****Ht*******WW******Ht**1lr*****HrHrHrHt**y 

Get_Call  (fp,  string) 

FILE  »fp; 

char  ^string; 


int  cifnum,  cal 1_finished, 

t_x.t  _y.m_x,m _y, 
m1n_x,  m1n_y,  max_x,  max_y; 

char  c,  r_x,  cel lname[15] .  portnamellS) ; 

cal l_finished  =  FALSE; 
while  (cal l_fin1shed  ==  FALSE) 

{ 

In_Fi 1 e  (fp,  '  ' ,  string) ; 

if  (string(l)  ==  'E'  &&  string(2)  ==  'N'  &&  string[31  == 
{ 

In_File  (fp,  '\n’,  string); 
call  finished  =  TRUE: 


E 


’^J  '•*."  I  ',i .'  '.■  y»rv»  ■ 


y: 


k 


else  If  {string[ll  ==  'C') 

{ 

In_File  (fp,  ‘  ',  cellname); 
t_x  =  6et_Mum  (fp); 
t_y  =  Get_Mum  (fp); 

In_F11e  (fp,  '  string); 
min_x  =  Get_Nuin  (fp); 
m1n_y  =  Get_Num  (fp); 
max_x  =  Get_Mum  (fp); 
max _y  =  Get_Mum  (fp); 

In_F11e  (fp.  'Nn',  string); 

) 

else  if  (str1ng[Q]  ==  'C') 

{ 

Get_C_Parameters  (&cifnum,  4m_x.  &n _y.  ir_x.  fp); 
Call_Tree  (cellname,  cifnum,  t_x,t_y,m_x,m_y.r_x, 
min_x,  min _y,  max_x,  max _y,  4call_ptr); 

) 

else  if  (string[0]  ==  '('  &&  string[l)  ==  ‘P’) 

{ 

In_F11e  (fp.  ')’,  portname); 

In_File  (fp.  '\n',  string); 

Port_Call  Place  (portname.  c  port_ptr); 

} 

) 

) 

#enclif 
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#ifneed  Get_C_Parameters 

*  * 

*  Module  Name:  Get_C_Parameters  * 

*  Module  Number:  2. 1.6.1  * 

*  Version/Date:  1.0  17  September  1985  * 

*  Input  Parameters:  fp  * 

*  Output  Parameters:  clfnum,  m_x,  m _y.  r_x  * 

*  Globa Is  Used:  none  * 

*  Modules  Called:  Get  Num  * 

*  Calling  Modules:  Get_Cen.  FINALIZE  Main  * 

*  Function:  Read  calls  parameters  from  disk  into  main  memory  * 

*  POL:  * 

*  Get  the  cifnum;  * 

*  While  not  end  of  current  line  * 

*  If  next  param  is  translation  * 

*  Get  the  translated  position;  * 

*  else  if  the  next  param  is  a  mirroring  * 

*  Get  the  mirror  in  x  or  y;  * 

*  else  if  the  next  param  is  a  rotation  * 

*  Interpret  the  rotation.  * 


************************************************************************  j 

Get_C_Parameters  (cifnum,  m_x,  m _y,  r_x,  fp) 


int 

*c1fnum,  *m  x. 

char 

*r_x; 

FILE 

’^fp; 

{ 

char 

c; 

*c i f num 

=  Get_Num(fp); 

*m  X  =  ’ 

''m_y  =  0; 

*r  x  = 

1  *  m 

• 

•  •  •  •  ► 

I'M 


while  {(c  =  getc(fp))  !=  '\n') 
( 

if  (c  ==  'T') 

{ 

getc  (fp); 

Get_Nuffl  (fp); 

Get_Num  (fp); 


ffifneed  Get_Iter 
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*  * 

*  Module  Name;  Get_Iter  * 

*  Module  Number;  2.1.7  * 

*  Version/Date;  1.0  17  September  1985  * 

*  Input  Parameters;  fp,  string  * 

*  Output  Parameters;  none  * 

*  Globals  Used;  c_port_ptr,  tter_ptr,  1_call_ptr  * 

*  Modules  Called;  ~In_File.  Get_Mum,  Call_Tree.  Get_C_Parameters  * 

*  Iter_Tree,  Port_Cal 1_P1ace  * 

*  Calling  Modules;  Get_Cell  * 

*  Function;  Read  iters  from  disk  into  main  memory  * 

*  POL;  * 

*  While  not  finished  getting  iter  statements  * 

*  If  next  input  is  end  of  iter  marker  * 

*  Set  finished  to  false;  * 

*  else  if  next  input  is  a  iter  statement  * 

*  Get  call  parameters.  * 

*  Place  parameters  in  call  tree  structure;  * 

*  else  if  next  input  is  a  portname  * 

*  Get  the  portname,  * 

*  Place  the  port  with  the  call.  * 

*  * 

#******llf**»*»*****»W******W**W*****HrimrHt<t*WW*******HrW»**'»*****Hr**********  j 

6et_Iter  (fp,  string) 

FILE  *fp; 

char  *string; 

{ 

int  cifnum,  finished, 

"-X.  n_y.  x_P.  y_p. 

t_x,  t_y,  m_x.  my, 
min_x,  min_y,  max  x,  max _y; 

char  c,  r_x,  ceHname{151,  portname!  15) ; 

finished  =  FALSE; 
while  (finished  ==  FALSE) 

{ 

In_File  (fp,  '  ' ,  string); 

if  (stringllj  ==  'E'  &&  stringl2)  ==  ’N'  &&  string[3)  ==  ’O') 

{ 

InFile  (fp,  '\n',  string); 
finished  =  TRUE; 


else  If  (stringlD  =*  '  I' ) 

{ 

In_File  (fp,  ‘  cellname); 

n_x  =  Get_Num  (fp);  n_^  =  Get_Mum  (fp); 

x_p  =  Get_Num  (fp);  y_p  =  Get_Mum  (fp); 

t_x  =  Get_Num  (fp);  t_y  =  Get_Mum  (fp); 

mjn_x  =  Get_Num  (fp); 

in1n_y  =  Get_Num  (fp); 

max_x  =  Get_Num  (fp); 

max _y  =  Get_Num  (fp); 

In_File  (fp,  '\n',  string); 
while  (getc(fp)  f=  'C'); 
getc(fp); 

Get_C_Paraffleters  (icifnum,  lim_x.  &m _y.  &r_x.  fp); 

Iter_Tree  (cellname,  cifnum,  n_x,  n_y,  x_p,  y_p,  &iter_ptr); 
Can_Tree  (cellname,  cifnum,  t_x,  t _y,  m_x,  m _y,  r_x, 
min_x,  min_y,  max_x,  max_y,  i_call_ptr); 

) 

else  if  (stringdl  =*  'P') 

{ 

In_Fi1e  (fp,  ')',  portname); 

In_Fi1e  (fp,  'Nn*,  string); 

Port_Ca11  Place  (portname,  c_port  ptr); 

} 

else  In  File  (fp,  '\n‘,  string); 

> 

#endif 


#1fneed  OPM_Menu 
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* 

* 

it 

Module  Name;  DPM_Menu 

* 

* 

Module  Number:  2.2 

* 

* 

Version/Oate:  1.0  26  August  1985 

* 

* 

Input  Parameters;  p_cellname 

★ 

* 

Output  Parameters:  none 

a 

Global s  Used;  space_used.  AVAIL_SPACE 

* 

it 

Modules  Called:  Get  Option 

* 

* 

Calling  Modules;  Main  (2.0) 

* 

* 

Function:  Display  options  available  for  dpm 

* 

* 

POL: 

* 

* 

Uhile  not  a  valid  option 

* 

* 

Display  options. 

★ 

* 

Get  desired  option; 

it 

it 

it 

Return  option. 

it 

it 

*★***★★*****★★*■***★******<»★★**★******♦**»*★******★#**********»***★★*★**★ j 


DPM_Menu  (p_cellname) 


char  *p_ce11naffle; 


{ 

char  option; 

int  opt1on_va1 id, 

space_left: 

option_valid  =  FALSE; 
while  Toption_va1 id  ==  FALSE) 

{ 

space_left  =  AVAIL_SPACE  -  space_used; 

printf  ( '‘\n\n\t\t\t\t  Memory  space  left:  *d\n",  space_left); 

printf  ("\n\n\n\n  Options  available  for  cell  *s  are  \n\n'',  p_cellname); 

printf  ("\n  C  =  place  Call  statement  \t  P  =  Print  work  \n"); 

printf  ("\n  I  =  Iterate  a  call  \t  E  =  Exit  to  main  menu  \n"); 

printf  ("Nn  M  =  Modify/Oelete  a  call  \t  after  saving  cell  \n*'); 

printf  ("\n  0  =  Oelete/Modify  an  \t  Q  =  Quit  to  system  \n”); 

printf  ("\n  Iterate  statment  \n"); 

printf  ("\n\n\n  SELECT  OPTION  (C. I .M.O.P.E.Q):  "); 

option  =  Get_0ption  (); 

if  {option  ==  'C  II  option  ==  ’I’  ||  option  ==  'M'  ||  option  ==  'O' 
lloption  ==  'P*  11  option  ==  ‘E’  11  option  ==  'Q*) 
option_valid  =  TRUE; 

else  printf  ("\n\n  Option  *c  not  valid\n”,  option); 

) 

return  (option); 

} 


Nendif 


#1fneed  D_Iinp1ement 

*  Hr 

Module  Name:  D_Imp1ement 
Module  Number;  2.3 
Version/Date:  1.0  21  August  1985 

Input  Parameters;  option,  p_f11enaffle,  p_ce11name 
Output  Parameters;  none  * 

Globa Is  Used;  ca11_ptr.  fter_ptr  * 

Modules  Called;  Name_Ce11,  Det_Clfnum,  Get_0pt1on,  Place_Call,  * 
Mod  Call,  Iterate_Can,  Mod_Iter,  Prlnt_Mork,  * 

Save_Ce1 1  * 

Calling  Modules;  DPM  Main  * 

Function;  Implement  the  desired  option  * 

POL;  * 

If  option  Is  to  place.  Iterate,  modify,  or  delete  calls  * 

Name  the  cell  to  be  used;  * 

Determine  the  cifnum;  * 

If  option  Is  to  place  or  Iterate  a  call  statement  * 

If  file  on  disk  * 

Get  the  bounds  of  this  cell,  * 

else  check  If  this  cell  name  correct  to  place.  * 

If  file  on  disk  or  place  Is  correct  * 

If  option  Is  to  place  • 

Place  a  call  statement;  * 

else  If  option  Is  to  Iterate  * 

Iterate  a  call  statement;  * 

else  If  option  Is  to  modify  or  delete  a  call  statement  * 
Print  Instructions,  * 

Modify  the  call  statements;  * 

else  If  option  Is  to  print  the  work  * 

Print  the  work;  * 

else  If  option  Is  to  save  the  cell  * 

Save  the  cell  to  disk.  * 


* 

* 

* 

* 

★ 

* 

* 

* 

★ 

* 

* 

* 

•k 

* 

* 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 
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D_Imp1ement  (option,  p_filename,  p_cellname) 
char  option, 

*p_f 1 lename, 

*p_cel iname; 

{ 


Int 

on_d1sk,  cifnum, 

m1n_x,  m1n_y,  max_x,  max_y, 

place,  *exit,  finished; 

char 

FILE 

filename  [12],  cellname  [15], 
*fopen(),  *fp; 

string  [80]; 

if  (option  ==  'C*  II  option  ==  'I'  || 

option  ==  'M'  1 

1  option  ==  'O' ) 

{ 

printf  ("\n  Input  name  of  cell  :  "); 
Name_Cell  (&on_d1sk,  filename,  cellname); 
cifnum  =  Det_C1fnum  (cellname); 


if  (option  »=  ‘C  II  option  ==  'I') 

{ 

if  (on_disk  ==  TRUE) 

( 

finished  =  FALSE; 

fp  =  fopen  (filename,  "r“); 

while  (finished  =»  FALSk) 

{ 

while  (getc(fp)  !»  '(*)  In_File  (fp.  '\n'.  string); 
if  (getc(fp)  »=  'b'  &&  getc(fp)  *=  'o'  &&  getc(fp)  ==  'u') 

{ 

In_Fi 1e  (fp,  '  ' ,  string); 

In_File  (fp,  '  ',  string); 
min_x  =  Get_Nuffl  (fp);  min_y  =  6et_Num  (fp); 

max_x  =  Get_Nuffl  (fp);  max _y  =  Get_Num  (fp); 

finished  =  TRUE; 

} 

) 

fclose  (fp); 

) 

else 

{ 

printf  (“\n  Cell  »s  not  found  under  filename  Xs\n".cel1name.f11ename); 

printf  (”\n  Place  a  cell  by  this  name  anyway  (ret  or  N):  "); 

place  =  Get_0ption  (); 

} 

if  (on_disk  ==  TRUE  II  place  »=  '\n‘) 

( 

if  (option  ==  'C ) 

Place_Call  (mln_x,  min_y,  max_x,  max _y,  cifnum,  cellname); 
else  if  (option  ==  ' I' ) 

Iterate_Call  (min_x,  min_y,  maxx,  max_y,  cifnum,  cellname); 

} 

} 

else  if  (option  ==  'M'  ||  option  ==  '0') 

{ 

printf  ("Type  return  for  next  call.E  to  exit,  M  to  mod, 

or  0  to  0elete\n“); 

*exit  =  FALSE; 
if  (option  ==  'M' ) 

ModCall  (exit,  cifnum,  call_ptr); 
else  Mod_Iter  (exit,  cifnum.  iter_ptr); 

) 

} 

else  if  (option  ==  'P‘ ) 

PrintWork  (); 
else  if  (option  ==  'E'  ) 

Save_Cell  (pfilename,  p_cellname); 


#endif 


2 
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Module  Name:  Place_Can 
Module  Number;  2.3.1 
Verslon/Oate;  1.0  26  August  1965 

Input  Parameters;  min_x,  mln_y,  max_x,  max _j.  cifnum,  cellname 
Output  Parameters:  none 
Globals  Used:  ca11_ptr 

Modules  Called:  Get_0ption.  Cal l_Pararoeters,  C_Port_Names , 
Cal1_Tree 

Calling  Modules:  DPM  Main  (2.0) 

Function:  Place  a  call  statement  in  the  cell 
POL; 

While  not  finished  placing  calls  to  this  cell 
Determine  the  parameters  for  the  call; 

Place  the  parameters  in  the  tree  structure; 

Place  any  associated  port  names. 


Place_Call  (min_x.  min_y.  max_x,  max_y,  cifnum,  cellname) 


int 

char 

( 

int 

char 


min_x,  min _y,  max_x,  max _y,  cifnum; 
*ceTlname; 


i,  f inished_place,  t_x,  t _y,  m_x,  m _y; 
r_x,  portnaine  [15); 


finished_place  =  FALSE; 
while  {finlshed_place  ==  FALSE) 

( 

Cal l_Parameters  (cellname,  &t_x,  &t_y,  Sm_x,  &m_y,  &r_x); 

Call_Tree  (cellname,  cifnum,  t_x,  t_y,  m_x,  m_y,  r_x, 
min_x,  miny,  max_x,  max_y,  &call_ptr); 

C_Port_Names  ( ) ; 

printf  ( "Xn  Place  cell  *s  in  another  location  (ret  or  N):  ",  cellname); 
if  (Get_0ption  ()  !=  '\n‘) 
finished_place  =  TRUE; 
else  finished_place  =  FALSE; 

} 

} 

Nendif 


Otfneed  Cal l_Parameters 
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Module  Name:  Can_Parameters  * 

Module  Number;  2. 3. 1.1  * 

Version/Oate;  1.0  26  August  1985  * 

Input  Parameters:  cell  name  * 

Output  Parameters:  t_x.  t _y,  m_x.  m _y.  r_x  * 

Globals  Used:  none  * 

Modules  Called:  Get_0ption,  Get_Mum  * 

Calling  Modules:  Place_Call,  Iterate_Cal 1 ,  Mod_Call,  Mod_Iter  * 
Function:  Get  the  call  parameters  * 

POL:  * 

Get  x.y  location  for  bottom  left  corner  of  called  cell;  * 

Determine  If  cell  should  be  mirrored  in  x  and/or  y;  * 

Determine  position  of  x  axis  of  called  cell.  * 

it 


Cal l_Parameters  (cellname,  t_x,  t_y.  m_x,  m_.y.  r_x) 

char  *cellname,  *r_x; 

Int  *t_x,  *t _y,  *m_x,  *m _y; 


printf  ("\n  Enter  x  and  y  location  for  bottom  left  of  cell  »s\n" , cel  1  name) ; 
printf  ( "\n\t  X  location  :  "); 

*t_x  =  Get_Num  (0); 

printf  ("\n\t  Y  location  :  "); 

*t_y  =  Get_Num  (0); 

printf  {"\n  Do  you  want  this  cell  flipped  upside  down  (ret  or  N):  "); 

If  (Get_0pt1on  ( )  ==  '\n' ) 

*m_x  =  TRUE; 
else  *m_x  =  FALSE; 

printf  ("\n\t\t  Flipped  left  to  right  (ret  or  N);  "); 
if  (Get_0pt1on  ()  ==  '\n') 

*m_y  =  TRUE; 
else  *m_y  =  FALSE; 

printf  ("\n  Do  you  want  to  rotate  the  x  axis  (ret  or  N):  "); 
if  (Get_0ption  ()  ==  '\n') 

{ 

printf  ("\n\t  To  3,  6.  9.  or  12  o'clock  (3,6,9.12):  "); 
while  ((*r_x  =  Get_0pt1on  ())  !=  '3'  &&  *r_x  !=  '6' 

&&  *r_x  !=  '9'  &&  *r_x  !=  '1') 

{ 

printf  ( "\n  Option  %c  not  valid;  try  aga1n\n",  *r_x); 
printf  ( "\n\t  To  3,  6,  9,  or  12  o'clock  (3,6,9,12):  "); 

) 

) 

else  *r_x  =  ' 

) 

Nendlf 
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</1fneed  Cal1_Tree 

y ************************************************************************* 


Module  Name;  Call_Tree 
Module  Number:  2.3. 1.2 
Verslon/Oate:  1.0  21  August  1985 

Input  Parameters:  name,  cifnum,  t_x,  t _y,  m_x,  m _y,  r_x, 
ptr,  min_x,  mln_y.  max_x.  max _y 
Output  Parameters;  none 
Globa Is  Used:  space_used.  c_port_ptr 
Modules  Called;  Call_Tree  (recursion) 

Cal  1 Ing  .Modules:  6et_Call,  Ca11_Tree,  Place_Call,  Iterate_Call  * 
Function:  places  calls  Into  main  memory  * 

POL:  * 

If  the  location  being  examined  Is  empty  * 

Allocate  memory,  * 

Place  call  parameters  in  structure;  * 

else  * 


If  cifnum  to  be  placed  <  present  cifnum 


Go 
el  se 
Go 
else 
Go 


to  the  next  call  to  the  left; 

If  cifnum  to  be  placed  =  present 
to  the  next  call  in  the  middle; 
if  cifnum  to  be  placed  >  present 
to  the  next  call  to  the  right. 


cifnum 

cifnum 


* 

* 

* 

* 

* 

★ 

« 


Cal l_Tree  (name,  cifnum,t_x,t_y ,m_x,m_y,r_x,m1n_x,min_y,max_x,max_y ,ptr ) 
char  *naffle; 

struct  cal l_statement  **ptr; 

{ 

int  1 ; 


if  (*ptr  ==  NULL) 

{ 

spaceused  =  space_used  +  sizeof  (struct  cal l_statement ) ; 
*ptr  =  alloc  (sizeof(struct  cal 1_statement) ) ; 

(^ptr )->l_t_name  =  (*ptr )->e_name  =  (*ptr )->g_t_name  =  NULL; 
i  =  0; 

while  ( ( (*ptr )->cel Inamed 1  =  name(il)  !=  '\0' ) 

+-M; 


(*ptr )->c1fnum 

=  cifnum; 

(*ptr )->tran_x 

=  t_x; 

(*ptr )->tran_y 

=  t_y; 

(*ptr)->mir_x 

=  m_x; 

(*ptr )->mir_y 

= 

(*ptr )->rot_x 

=  r_x; 

^  ^  ^  •  -  < 


(*ptr  )->x_tn1n  =  m1n_x; 

(*ptr )->y_min  =  min _y; 

(*ptr)->x_max  =  max_x; 

(*ptr )->y_max  =  max_y; 

(*ptr )->c_ports  =  NULL; 
c_port_ptr  =  &(*ptr)->c_ports; 

} 

else 

if  (cifnum  <  (*ptr )->cifnum) 

Ca11_Tree  (name,  cifnum.  t_x.  t _y.  m_x.  m_y.  r_x. 

min_x.  min _y.  max_x.  max _y.  8i(*ptr)->1_t_name) 
else  if  (cifnum  ==  (*ptr )->cifnum) 

Ca11_Tree  (name,  cifnum.  t_x.  t_y.  m_x.  m _y.  r_x. 

min_x.  min_y.  max_x.  max_y.  4(*ptr)->e_name); 
else  if  (cifnum  >  (*ptr )->cifnum) 

Call_Tree  (name,  cifnum.  t_x.  t_y.  mx.  my,  rx. 

min_x.  min_y.  max_x.  max  y.  &(*ptr )->g_t_name) 

} 

#endif 


221 


ffifneed  C_Port_Names 
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Nodule  Name:  C_Port_Names 

Module  Number;  2.3. 1.3 

Version/Date:  1.0  26  August  1985 

Input  Parameters;  none 

Output  Parameters:  none 

Globa Is  Used:  c_port_ptr 

Modules  Called:  Get_0ptlon,  Port_Cal l_P1ace 

Calling  Modules:  P1ace_Ca11.  Iterate_Cal 1 ,  Mod_Cal1,  Mod_Iter 

Function:  Get  the  call  parameters 

POL: 

If  the  user  wants  to  place  portnames 
Mhlle  not  finished  placing  ports 
Get  the  portname; 

Place  the  port  name  with  the  call. 
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C_Port_Names  ( ) 


{ 

int 

char 


1,  finished; 
portname  (15]; 


finished  =  FALSE; 

printf  ("\n  Do  you  want  to  place  any  portnames  (ret  or  n);  ’’); 
If  (Get  Option  ( )  ==  '\n' ) 
while  (finished  ==  FALSE) 

{ 

printf  ("\n  Enter  port  name;  "); 

1  =  O; 

while  ( (portname(1 ]  =  getc(O))  !=  '\n') 

++i; 

portname! 1]  =  '\0‘; 

Port_Cal l_Place  (portname,  c_port_ptr); 
printf  (“\n  another  port  name  (ret  or  N):  “); 
if  (Get_0ption  ( )  !=  '\n' ) 
finished  =  TRUE; 

) 

) 

Nendif 


#ifneed  Port_Cal l_Pl ace 

■k  k 

*  Module  Marne:  Port_Ca1 l_Place  * 

*  Module  Number:  2. 3. 1.3.1  * 

*  Version/Oate:  1.0  10  September  1985  * 

*  Input  Parameters:  portname.  c_p_ptr  * 

*  Output  Parameters:  none  * 

*  Global s  Used:  space_used  * 

*  Modules  Called:  Port_Cal l_P1ace  (recursion)  * 

*  Calling  Modules:  Get_Call.  C_Port_Names ,  Port_Ca1 l_Place  * 

*  Function:  places  calls  ports  Into  main  memory  * 

*  POL:  * 

*  If  the  present  port  location  Is  empty  * 

*  Allocate  memory;  * 

*  Place  the  portname  In  the  structure;  * 

*  else  * 

*  Go  to  the  next  port  name  location.  * 

k  k 
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Port_Ca1 1_P1ace  (portname,  c_p_ptr) 


char  *portname; 

struct  named_ports  **c_p_ptr; 


if  (*c_p_ptr  =*  NULL) 

{ 

space_used  =  space_used  +  sizeof  (struct  named_ports ) ; 
*c_p_ptr  =  alloc  (sizeof  (struct  named_ports) ); 
i  =  0; 

while  { ( (*c_p_ptr)->port_name(11  =  portnamedl)  !=  '\0' ) 
++i; 

(*c_p_ptr )->next_name  =  NULL; 

) 

else 

Port_Cal 1_P1ace  (portname,  &(*c_p_ptr)->next_name); 

} 


Nendif 


#1fneed  Mod_Call 
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*  it 

*  Module  Name;  Mod_Cal1  * 

*  Module  Number:  2.3.2  * 

*  Version/Date;  l.O  21  August  1985  * 

*  Input  Parameters;  exit,  clfnum,  ptr  * 

*  Output  Parameters:  exit  * 

*  Global s  Used:  c_port_ptr  * 

*  Modules  Called:  Get_0pt1on,  Cal l_Parameters,  C_Port_Names  * 

*  Calling  Modules;  0_Imp1efflent  * 

*  Function;  Modify  a  call  statement  * 

*  PDL:  * 

*  If  present  location  Is  not  empty  and  exit  Is  false  * 

*  Walk  the  call  tree  to  the  left;  * 

*  if  exit  is  false  and  clfnum  Is  valid  * 

*  Print  the  call  statement,  * 

*  Determine  option,  * 

*  If  option  Is  to  exit  * 

*  Set  exit  to  true;  * 

*  else  if  option  Is  to  modify  and  mod  Is  to  delete  * 

*  Delete  this  call  statement;  * 

*  else  if  option  Is  to  modify  and  mod  is  to  modify  * 

*  Get  and  place  new  call  parameters;  * 

*  If  exit  is  false  and  there  are  ports  defined  * 

■*  Delete  or  modify  ports  as  needed;  * 

*  If  exit  is  false  * 

*  Walk  the  middle  call  tree;  ■* 

*  If  exit  is  false  * 

*  Walk  the  right  call  tree.  * 

*  * 

ifitititititiiisit'kititificitHHititititititicitititiiifitititititidfitititititititiciticifititicifititititifififititicititititiritiKitititit  j 

Mod_Call  (exit,  clfnum,  ptr) 

int  *exit,  cifnum; 

struct  cal l_statement  *ptr; 

{ 

char  option,  r_x,  portname[151 ; 

int  i,  exit_ports,  finished; 

if  (ptr  !=  NULL  &&  *exit  ==  FALSE) 

( 

Mod_Cal1  (exit,  cifnum,  ptr->l_t_name) ; 
if  (*exit  ==  FALSE  &&  cifnum  <=  ptr->cifnuffl) 

{ 

exit_ports  =  FALSE; 

prlntf  ("%s  %d,  %d  ",  ptr->cel Iname,  ptr->tran_x,  ptr->tran_y ) ; 
if  (ptr->m1r_x)  printf  ("Flip  UD  "); 

If  (ptr->mir _y)  prlntf  ("Flip  LR  "); 


^ *  •  »_•  • .  • « *  %• 


if  (ptr->rot_x  ==  T) 
printf  ("2“); 

} 

printf  (*•  (ret,  E.  M.  or  0):  "); 
option  =  Get_0pt1on  (); 
if  (option  “  •£•) 

*ex1t  »  TRUE; 
else  if  (option  ==  '0' ) 

( 

ex1t_ports  =  TRUE; 
ptr->c_ports  =  MULL; 
ptr->tran_y  =  -9999; 

} 

else  if  (option  ==  ‘M’ ) 

Cal l_Paraffleters  (ptr->cel Iname,  &ptr->tran_x,  &ptr->tran _y, 
&ptr->niir_x,  &ptr->mir _y.  &ptr->rot_x) ; 
c_port_ptr  =  ptr->c_ports; 
if  (c_port_ptr  !=  NULL  tl  *exit  »=  FALSE) 
print?  (“\nType  ret  for  next  port.  E  to  Exit,  M  to  Mod, 

or  0  to  0elete\n‘*); 

while  (*ex1t  ==  FALSE  &&  ex1t_ports  =»  FALSE  &&  c  port  ptr  !=  NULL) 

{ 

printf  ("\n  Port  *s  (ret,  E,  M,  or  0):  ",  c_port_ptr->port_name); 
option  =  Get_0ption  (); 
if  (option  »=  'E' ) 
exit_ports  »  TRUE; 
else  if  (option  ==  'D'  ) 
c_port  ptr->port  namefO]  = 
else  if  Toption  ==~‘M' ) 

{ 

printf  ("\n  New  port  name  :  "); 
i  =  0; 

while  ( (c_port_ptr->port_name(i 1  =  getc(O))  !=  '\n')  ++i; 

c  port  ptr->port_name( i 1  =  ’\0‘; 

)~ 

c  port_ptr  =  c_port_ptr->next_name; 

c_port_ptr  =  &ptr->c_ports; 

if  (*exit  ==  FALSE  &&  exit_ports  ==  FALSE) 

C_Port_Names  (); 

} 

if  (*exit  ==  FALSE) 

Mod_Call  (exit,  cifnum,  ptr->e_name) ; 
if  (*exit  ==  FALSE) 

Mod_Ca1l  (exit,  cifnum,  ptr->g  t  name); 

) 

} 

ffendif 


#1fneed  Iterate_Call 
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Module  Name:  Iterate_CaU  * 

Module  Number:  2.3.3  * 

Version/Date:  1.0  21  August  1985  * 

Input  Parameters:  m1n_x.  mln_y,  max_x.  max_^,  clfnum,  cellname  * 

Output  Parameters:  none  * 

Global s  Used:  1ter_ptr,  l_can_ptr  * 

Modules  Called:  Cal l_Parameters,  Iter_Parameters,  Iter_Tree,  * 
Can_Tree.  C_Port_Names  * 

Calling  Modules:  0_lmplement  * 

Function:  Get  the  Iteration  Information  from  the  user  * 

POL:  N/A  * 

★ 
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Iterate_Cal1  {m1n_x,  m1n_y,  max_x,  max _y,  clfnum,  cellname) 


char  *cellname; 

{ 

Int  n_x,  n_y, 

x_P.  y_p. 

t_x,  t_y,  m_x,  m_y,  r_x; 


Cal l_Parameters  (cellname,  &t_x,  it _y,  im_x,  im _y,  ir_x); 
Iter_Parameters  (in_x,  in _y,  ix_p,  iy_p,  m1n_x,  min _y,  max_x,  max_y); 
Iter_Tree  (cellname,  clfnum,  n_x,  n_y,  x_p,  y_p,  i1ter_ptrT; 

Ca11_Tree  (cellname,  clfnum,  t_x,  t _y,  m_x,  m _y,  r_x,  m1n_x,  m1n_y, 
max_x,  max_y,  T_call_ptrT; 

C_Port_Names  ( ) ; 

} 


Nendif 


#1fneetl  Iter_Parameters 
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Module  Name:  Iter_Parameters  * 

Module  Number:  2.3.3. 1  * 

Version/Date:  1.0  17  September  1985  * 

Input  Parameters:  m1n_x.  min _y,  max_x,  max _y  * 

Output  Parameters:  n_x,  n _y,  x_p,  y_p  * 

Ulobals  Used:  none  * 

Modules  Lai  led:  (3et_Num  * 

tailing  Modules:  Iterate_Can,  Mod_Iter  * 

l-unction:  (jet  the  necessary  parameters  tor  Iterating  a  cell  * 

PUL:  N/A  * 

* 


*»»***»*********»#*■******»***********»★***»**♦*★***************★**★***★*  j 

Iter_Parameters  (n_x,  n _y,  x_p.  y_p.  mln_x,  m1n_y,  max_x,  max_y) 


int  *n_x,  *n_y,  *x_p,  *y_p; 


{ 

printf  (“\n  Input  the  number  of  Iterations  In  the  x  direction:  “): 
*n_x  =  Get_Num  (0); 

printf  ("\n\t\t  Number  In  the  y  direction: 

*n_y  =  Get_Num  (0); 

printf  ("\n  Input  the  x  pitch  or  return  for  bounding  box  default:  "); 
*x_p  *  Get  Num  (0); 
if  {*x_p  ==  0) 

*x_p  *  max_x  -  m1n_x; 

printf  ("\n\t\t  Y  pitch  or  return  for  default:  “); 

*y_p  =  Get  Num  (0); 
if  {*y_p  =“  0) 

*y_P  =  max_y  -  min _y; 

) 


#endif 


I 


#ifneed  Iter_Tree 
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*  Module  Name:  Iter_Tree  * 

*  Module  Number:  2. 3. 3. 2  * 

*  Version/Date:  1.0  21  August  1985  * 

*  Input  Parameters:  name,  cifnura,  t_x.  t _y.  m_x,  m _y.r_x,r _y.ptr  * 

*  Output  Parameters:  none  * 

*  Global s  Used:  space_used  * 

*  Modules  Called:  Iter_Tree  (recursion)  * 

*  Calling  Modules:  Iterate_Cell ,  Call_Tree  * 

*  Function:  places  Iterates  Into  main  memory  * 

*  POL:  * 

*  If  the  location  being  examined  Is  empty  * 

*  Allocate  memory,  * 

*  Place  call  parameters  In  structure;  * 

*  else  * 

*  If  clfnum  to  be  placed  <  present  cifnum  * 

*  Go  to  the  next  call  to  the  left;  * 

*  else  If  clfnum  to  be  placed  =  present  clfnum  * 

*  Go  to  the  next  call  In  the  middle;  * 

*  else  if  clfnum  to  be  placed  >  present  clfnum  * 

*  Go  to  the  next  call  to  the  right.  * 

**«**«4r4rW*4t4r4r*tlt4r4r*4r**4rA4r4r*ir*******4t*4r*4t**4r**4tA***1lr4r**4t**4r*4r4r4r4r**4t**W4t4r*4t  j 

Iter_Tree  (name,  clfnum,  n_x,  n _y,  x_p,  y_p,  ptr) 
char  ^narne; 

struct  Iter  statement  **ptr; 

( 

1  nt  1 ; 

if  (*ptr  “  NULL) 

{ 

space_used  =  space_used  +  slzeof  (struct  1ter_statement) ; 

*ptr  =  alloc  (slzeof (struct  iter_statempnt) ); 

(*ptr)->l_t  cifnum  =  (*ptr )->e_cifnum  =  (*ptr )->g_t_clfnum  =  NULL; 
1=0; 

while  ( ( (*ptr )->cel lname(1 1  =  name(l])  ?=  ’\0' )  ++1; 

|*ptr  )->cifnum  =  cifnum; 

(*ptr )->x_1ters  =  n_x;  {*ptr)->y_iters  =  n_y; 

(*ptr )->x_pltch  =  x_p;  (*ptr )->y_pitch  =  y_p; 

(*ptr)->i_ca11  =  NULL; 
i_call_ptr  =  &(*ptr )->i_cal 1 ; 

} 

else 

{ 

if  (cifnum  <  (*ptr )->cifnum) 

Iter_Tree  (name,  clfnum,  n_x,  n_y,  x_p,  y_p,  &(*ptr)->l_t_cifnum); 
else  if  (clfnum  ==  (*ptr )->clfnum) 

Iter_Tree  (name,  clfnum,  n_x,  n_y,  x_p,  y_p,  &(*ptr)->e_clfnum); 
else  If  (clfnum  >  (*ptr )->c1fnum) 

Iter_Tree  (name,  clfnum,  n_x,  n_y,  x_p,  y_p,  8i(*ptr )->g_t_cifnum) ; 

) 

} 

#end1f 
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ffifneed  Mod_Iter 
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Module  Name:  Hod_Iter 

Module  Number:  2.3.4 

Verslon/Oate:  1.0  17  September  1985 

Input  Parameters:  exit,  cifnum.  ptr 

Output  Parameters:  exit 

Globa Is  Used:  c_port_ptr 

Modules  Called:  Get_0ption,  Iter_Parameters.  Cal 1_Parameters, 
C_Port_Names 

Calling  Modules:  0_Imp1ement 

Function:  Modify  an  Iteration  of  call  statements 

POL: 

If  present  location  Is  not  empty  and  exit  Is  false 
Walk  the  call  tree  to  the  left; 

If  exit  Is  false  and  cifnum  Is  valid 
Print  the  call  statement. 

Determine  option. 

If  option  Is  to  exit 
Set  exit  to  true; 

else  If  option  Is  to  modify  and  mod  Is  to  delete 
Delete  this  call  statement; 
else  If  option  is  to  modify  and  mod  is  to  modify 
Get  and  place  new  call  parameters; 

If  exit  is  false  and  there  are  ports  defined 
Delete  or  modify  ports  as  needed; 

If  exit  is  false 
Walk  the  middle  call  tree; 

If  exit  Is  false 
Walk  the  right  call  tree. 
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Mod^Iter  (exit,  cifnum,  ptr) 


Int 


*ex1t,  cifnum; 
struct  1 ter_statement  *ptr; 

option,  r_x,  portname(15] ; 
1,  ex1t_ports,  finished; 


char 

int 


if  (ptr  !=  NULL  &&  *ex1t  ===  FALSE) 

{ 

Mod_Iter  (exit,  cifnum,  ptr->l_t_c1fnum) ; 
if  (*ex1t  ==  FALSE  &&  cifnum  <=  ptr->cifnum) 

{ 

ex1t_ports  =  FALSE; 

printf  (''%s  %dx%d  ",  ptr'>cel Iname,  ptr->x_i ters,  ptr->y_1ters) ; 
printf  ("Pitch  *d,  %6  ",  ptr-'>x_pitch.  ptr->y_p1tch); 

printf  ("T  %d,  %d  ",  ptr->1_call->tran_x,  ptr->1_cal 1 ->tran _y); 
if  (ptr->1_call->m1r_x)  printf  ("Flip  UD  "); 
if  (ptr->1  cal]->m1r _y)  printf  ("Flip  LR  "); 


printf  ("R  *c  ,  ptr->1  cal l->rot_x); 
if  (ptr->i_call->rot_x~==  T)  printf  ("2“); 
printf  ("  (ret,  E.  M.  or  D):  "); 
option  =  Get_0ption  (); 
if  (option  ==  'E' ) 

*ex1t  =  TRUE; 
else  if  (option  ==  'O' ) 

{ 

exit_ports  =  TRUE; 
ptr->i_cal 1 ->c_ports  =  NULL; 
ptr->x_iters  =  -9999; 

} 

else  if  (option  ==  'M' ) 

( 

Iter_Parameters  (&ptr->x_iters.  &ptr->y_iters, 

&ptr->x_pitch.  &ptr->y_pitch,  ptr->i_cal l->x_min, 
ptr->i_ca1 1 ->y_min,  ptr->i_cal l->x_max,  ptr->i_cal 1 ->y_tnax) ; 

Cal 1_Parameters  (ptr->cel Iname,  &(ptr->i_cal 1 ->tran_x ) , 
i(ptr->i_call->tran _y).  &(ptr->i_can->mir_x), 

4(ptr->i_cal 1 ->mir _y).  4(ptr->i_cal 1 ->rot_x) ) ; 

} 

c_port_ptr  =  ptr->i_cal l->c_ports; 
if  (c_port_ptr  !=  NULL  44  *ex1t  ==  FALSE) 

printf  ("\nType  ret  for  next  port.  E  to  Exit,  M  to  Mod,  or  0  to  De1ete\n"); 
while  (*exit  ==  FALSE  44  exit  ports  ==  FALSE  44  c  port  ptr  !=  NULL) 

{ 

printf  {"\n  Port  *s  (ret,  E,  M,  or  D):  ",  c_port_ptr->port_name) ; 
option  =  Get  Option  ( ); 
if  (option  ==  'E') 
exit_ports  =  TRUE; 
else  if  (option  ==  '0' ) 
c_port_ptr->port_name(Oi  = 
else  if  (option  ==  'M' ) 

( 

printf  ("\n  New  port  name  :  "); 
i  =  0; 

while  ( (c_port_ptr->port_nameli 1  =  getc(O))  !=  ’\n')  ++i; 

c_port_ptr->port_name[i 1  =  '\0'; 

) 

c_port_ptr  =  c_port_ptr->next_name; 

} 

c_port_ptr  =  4ptr->i_cal 1 ->c_ports; 
if  (*exit  ==  FALSE  44  exitports  ==  FALSE) 

CPortNames  ( ) ; 

if  (*exit  ==  FALSE) 

Moditer  (exit,  cifnum,  ptr->e_cifnum) ; 
if  (*exit  ==  FALSE) 

Moditer  (exit,  cifnum,  ptr->g_t_cifnum) ; 


#endif 


E 
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it  * 

*  Program  Name:  MODIFY. C  * 

*  Version/Date:  1.0  11  August  1985  * 

«  * 

*  Function:  This  subprogram  to  HDCLL.C  modifies  an  already  * 

*  existing  cell.  Option  are  to  add  the  cell,  delete  * 

*  from  the  cell,  or  change  cell  parameters.  * 

*  Hr 

*  Include  Files  Needed:  HODLIB.LIB,  DPHLIB.LIB.CRE8LIB.LIB.  * 

*  STOLIB.C,  HDCLL.H  (which  Includes  tprintf.c,  exec.c,  * 

*  and  all  global  variables  needed  In  the  mdcll  system)  * 

*  * 

*  Program  Hierarchy:  See  next  page  * 

*  * 


^include  "mdcll. h" 


y********************************#**********!***************************** 

*  3.0  MODIFY  Main  * 

*  I  * 

*  I - 1,1*  Name_Cen  * 

*  1  * 

*  I - 1.2.1*  Get_Option  * 

it  I  * 

*  I - 2.1*  Get_Cen  * 

*  1  * 

*  I - 3.1  Oet_Mod  * 

*  I  I - 1.2.1*  Get_0pt1on  * 

*  I  * 

*  I - 1.2*  C_Menu  * 

*  I  * 

*  1 - 1.3*  Implement  * 

*  I  * 

*  I - 3.2  M_Menu  * 

*  I  I - 1.2.1*  Get_0ption  * 

*  I  * 

*  1 - 3.3  M  Implement  * 

*  I  * 

*  I - 1.3,6*  Print  Work  * 

*  I  * 

*  I - 1.3.7*  Save_Cen  * 

*  I  * 

*  I - 1.3. 1.1*  Oef  Layer  * 

*  I  * 

*  I - 1.3. 1.2*  Get  Num  * 

*  I  * 

*  1 - 3.3. Ir  Mod_Port  * 

*  I  I - 1.2,1*  Get_Option  * 

*  I  I - 1.3. 1.1*  Def_Layer  * 

*  I  I - 1.3. 1.2*  Get_Num  * 

*  I  * 

*  I - 3.3.2r  Mod_Rect  * 

*  I  I - 1.2.1*  Get_Option  * 

*  I  I - 1.3. 1.2*  Get_Num  * 

*  I  I - 1.3.2. 1*  Rect_Tree  * 

*  I  * 

*  I - 3.3.3r  Mod_Wire  * 

*  I  I - 1.3. 6. 3.1*  Segment_Tree  * 

*  1  I - 1.2.1*  Get_Option  * 

*  1  I - 1.3. 1.2*  Get_Mum  * 

*  I  1 - 1.3.3. 1*  S_Mire_Tree  * 

*  I  1 - 1.3. 3. 3*  Place_Wi re_Parameters  * 

*  I  * 

*  1 - 3.3.4r  Mod_Via  * 

*  I  I - 1.2.1*  Get_Option  * 

*  1  I - 1.3. 1.2*  Get_Mum  * 

*  I  I - 1.3. 4.1*  Via_Tree  * 

*  I - 3.3.5  Mod_F1ash  * 

******»1Hlr****1»********»*******************************************’''*****/ 


fitirititititit'kititititiritftitittcitititirititilititit'kifirifitirifit'kieitit'kit'k'kitit'k'k'k'kicit'fticitit'kic'kiticiritif'ititie'k'kicitif 


Module  Name:  Main 

Module  Number;  3.0 

Version/Date:  1.0  21  August  1985 

Input  Parameters:  none 

Output  Parameters',  none 

Globals  Used:  none 

Modules  Called:  Det_Mod.  Name_Cell,  Get_^Ce11,  C_Menu, 

M_Menu.  M_Implement.  Get_0pt1on,  Implement 
Calling  Modules:  NOCLL  program 
Function;  Modify  an  already  existing  CIF  cell 
POL; 

While  not  finished  modifying 
Name  the  cell  to  be  modified; 

If  not  found  on  disk 

If  shouldn't  try  search  for  file  again 
Set  finished  modifying  to  true; 

else 

Set  finished  modifying  to  true. 

Get  the  cell  to  be  modified. 

Determine  the  type  of  modification, 
if  mod  Is  to  add  to  the  cell 
While  create  menu  option  other  than  quit 
Implement  the  desired  option, 
else  If  mod  Is  to  delete  or  change  cell  parameters 
While  modify  option  other  than  quit 
Implement  the  desired  modification. 


*  * 

ma1n( ) 

{ 

Int  finished, 
on_d1sk; 


char 


mod, 
option, 
cel 1name[15] , 
f 1 lenameilZ] ; 


prlntf  ( "XnNnXnXnNnNnXnNtNt  READY  TO  MODIFY  A  CELL  \n\n\n\n\n\n" ) ; 

finished  =  FALSE; 

while  (finished  ==  FALSE) 

{ 

prlntf  ("\n  Enter  Name  of  cell  to  be  modified;  "); 

Name  Cell  (&on  disk,  filename,  cell  name); 


if  (ondisk  ==  FALSE) 

printf  ("\n  Can't  find  filename  *s;  try  again  (return  or  N);  ",  filename) 
if  (Get_0ption  ()  !=  •\n') 
finished  =  TRUE; 

) 

else 

{ 

finished  =  TRUE; 

6et_Cell  (filename,  cell  name); 
mod  =  Det_Mod  ( ) ; 
if  (mod  ==  ’ A' ) 

while  ((option  =  C_Menu  (cellname))  !=  'Q') 

Implement  (option,  filename,  cellname); 
else  if  (mod  ==  'M' ) 

while  ((option  =  M_Menu  (cellname))  !=  'Q') 

M  Implement  (option,  filename,  cellname); 

} 

> 

} 

Kinclude  "modi  1b. 1 ib“ 

#1nc1ude  "dpml lb. 1 ib" 
include  “creSl ib.  1  ib" 

^include  "stdiib.c" 


#1fneed  Det  Mod 

/*★***★★********★*★*<»*******★**★*★********★****************************** 
*  * 

*  Module  Name;  Det_Mod  * 

*  Module  Number:  3.1  * 

*  Version/Date:  1.0  11  August  1985  * 

*  Input  Parameters:  none  * 

*  Output  Parameters:  mod  * 

*  Global s  Used:  none  * 

*  Modules  Called;  Get_0ptlon  * 

*  Calling  Modules:  Main  (3.0)  * 

*  Function:  Determine  modification:  either  Add,  Modify,  or  Quit  * 

*  PDL;  * 

*  While  type  of  modification  is  not  valid  * 

*  Display  available  options;  * 

*  Get  the  option.  * 

*  * 
★^Ht******^**********!*#**************************************************/ 

Oet_Mod  ( ) 

{ 

int  mod_va1id; 

char  mod; 

mod_va1id  =  FALSE; 
whiTe  (mod_valid  ==  FALSE) 

printf  ("\n  Do  you  want  to  \n\n\t\t  A  =  Add  to  this  cell  \n"); 
printf  r'\n\t\t  M  *  Modify  cell  parameters  \n’'); 
printf  ("\n\t\t  Q  =  Quit  to  operating  system  \n"); 
printf  ("\n\n  Select  Option  (A,M,Q):  "); 
mod  =  Get_0ption  (); 

if  (mod  ==  'A'  II  mod  ==  'M'  ||  mod  ==  'Q') 
mod_valid  =  TRUE; 

else  printf  ("\n  Option  *c  not  valid  \n'',mod); 

) 

return  (mod); 

) 

#endif 


#1fneed  M_Henu 

^icititieititititititititititi(i(icitititi(itititititici(i(ititicitititi(itititiricit'kitititifieitifik'kiieieicici>cic'kirifirieiriri(irifitititlt 


*  Module  Maine:  M_Menu  * 

*  Module  Number:  3.2  * 

*  Version/Date:  1.0  11  August  1985  * 

*  Input  Parameters;  cell  name  * 

*  Output  Parameters:  none  * 

*  Global s  Used;  none  * 

*  Modules  Called:  Get_0pt1on  * 

*  Calling  Modules:  Main  (3.0)  * 

*  Function;  Display  options  for  changes  or  deletions  to  a  cell  * 

*  PDL:  * 

*  While  option  is  not  valid  * 

*  Display  the  menu  of  options;  * 

*  Get  the  desired  option.  * 

*  * 


M_Menu  (cell name) 

char  *cellname; 

{ 

char  option; 

int  option_val id, 

space_Teft; 

option_valid  =  FALSE; 
while  Toption  valid  ==  FALSE) 

{ 

space_left  =  AVAIL_SPACE  -  space_used; 

print?  ("\n\t\t\t  Memory  space  used;  *d  \n'’,  space_left); 

printf  ("\n\n  Options  available  for  cell  Xs  are:  \n\n",  cellname); 

printf  r'\n  Modify  a;  \t\t\t  or:  \n\n“); 

printf  ("\n  R  =  Rectangle  (box)  \t\t  P  =  Print  work  \n*'); 

printf  ("\n  W  =  Mire  \t\t\t  E  =  Exit  to  main  menu  \n"); 

printf  ("\n  V  =  Via  (contact)  \t\t  after  saving  file  \n"); 

printf  ( "\n  F  =  round  Flash  \t\t  Q  =  Quit  to  system  \n"); 

printf  ("\n  I  =  Interconnection  port  \n“); 

printf  ("\n\n  SELECT  OPTION  (R.W.V.F, I .P.E.Q) :  "); 

option  =  Get_0ption  (); 

if  (option  ==  'R'  ||  option  ==  'W*  )|  option  ==  'V  ||  option  ==  'F' 

lloption  ==  T  11  option  ==  ’P'  M  option  ==  ‘E’  11  option  ==  'Q') 

option_va1id  =  TRUE; 

else  printf  ("Option  Xc  not  valid  \n",  option); 

) 

pr i ntf  ( "\n\n\n\n\n\n\n\n\n\n\n " ) ; 
return  (option); 

} 

Nendif 


236 


#1fneed  H  Implement 

/ 

* 


Nodule  Number:  3.3 

Version/Date:  1.0  11  August  1985 

Input  Parameters:  option,  mod.  filename,  cell  name 

Output  Parameters:  none 

Globa  Is  Used:  port_ptr.  wire_ptr.  f_rec*.  s_rect.  p_rect. 
d_rect.  s_via.  p_vla.  d_via 

Modules  Called:  Def_Layer.  Get_Num.  Mod  Rect.  Print_Hork. 

Mod_Hire.  Mod_V1a.  Hod_Flash.  Mod_Port.  Save.Cell 
Calling  Modules:  Main  (3.0) 

Function:  Implement  functions  for  changes  or  deletions 
POL: 

If  option  is  to  print  work 
Print  the  work; 

else  if  option  is  to  save  the  ceil 
Save  the  cel  1  to  disk; 
else 

If  option  other  than  modify  a  port 
Get  layer  and  x  location  for  modification. 

Print  instructions. 

If  option  is  to  modify  an  interconnection  port 
Modify  a  port. 

else  if  option  is  to  modify  a  rectangle 
Modify  a  rectangle  based  on  layer, 
else  if  option  is  to  modify  a  wire 
Modify  a  wire  based  on  starting  layer, 
else  if  option  is  to  modify  a  via 
Modify  a  via  based  on  layer, 
else  if  option  is  to  modify  a  flash 
Modify  a  flash. 


it'kitifitit'kitititititif'k'k'kifit'kitit'kit'k'k'k'kit'kititit'kit'k'kifit'k'k'kititit'kit'kif'kititit'k'kiKititifitifititit'k'k'k’kit'kitit'k  j 

M_Implement  (option,  filename,  cellname) 
char  option,  *filename,  *cellname; 


{ 

int 


*exit, 

location; 


if  (option  ==  'P' ) 

Print_Hork  (); 
else  if  (option  ==  '£'  ) 

Save_Cell  (filename,  cellname); 
else 
( 


if  (option  !=  r ) 

{ 

if  (option  !=  'W ) 

{ 

printf  (“\n  Input  the  layer  for  this  modif ication\n“ ) ; 

Oef_Layer  ( ) ; 

} 

printf  ("Nn  Input  the  x  location  if  known  (return  or  number):  “); 
location  =  Get_Mum  (0); 

> 

printf  (''\n  Type  return  for  next.  E  to  Exit,  M  to  Modify,  or  0  to  Oelete\n“); 
*ex1t  =  FALSE; 
if  (option  ==  ' I ' ) 

Mod_Port  (port_ptr); 
else  Tf  (option  ==  'R' ) 

{ 

if  (layer  ==  *F')  Mod_Rect  (exit,  location,  f_rect); 

else  if  (layer  ==  ’S')  Mod_Rect  (exit,  location,  s_rect); 

else  if  (layer  ==  ‘O')  Mod_Rect  (exit,  location,  d_rect); 

else  if  (layer  ==  ‘P’)  Mod_Rect  (exit,  location.  p_rect); 

> 

else  if  (option  ==  'W ) 

Mod  Wire  (exit,  location.  wire_ptr); 
else  Tf  (option  ==  'V  ) 

{ 

if  (layer  »=  'S')  Mod_Via  (exit,  location,  s_via); 
else  if  (layer  ==  'O'T  Mod_Via  (exit,  location,  d_via); 
else  if  (layer  ==  'P')  Mod  Via  (exit,  location,  p  via); 

} 

else  if  (option  ==  'F' ) 

Mod  Flash  ( ); 

} 

) 

(iendif 


#1fneed  Mod_Port 

y ***★**★****»**»**★***★★*****★**★★****■**!»***★****#*********★★*★********** 

*  Module  Name:  Mod_Port  * 

*  Module  Number;  3.3.1  * 

*  Version/Date:  1.0  9  September  1985  * 

*  Input  Parameters:  p_ptr  * 

*  Output  Parameters;  none  * 

*  Globals  Used:  layer  * 

*  Modules  Called;  Get_0pt1on,  Def_Layer.  Get_Num  * 

*  Calling  Modules:  H_Implefflent  * 

*  Function:  Modify  the  port  * 

*  PDL:  * 

*  If  a  port  Is  defined  at  this  location  * 

*  If  port  hasn't  been  deleted  * 

*  Print  port  parameters;  * 

*  Determine  option;  * 

*  If  option  Is  to  delete.  Delete  the  port;  * 

*  else  If  option  Is  to  modify  * 

*  Get  new  port  parameters;  * 

*  If  not  exit  * 

*  Go  to  next  port.  * 

*★*★**#********★*■*♦*****★********★*★***★**■***********★****★********■***★*/ 
Mod_Port  (p_ptr) 

struct  Inter  ports  *p_ptr; 

{ 

char  option; 

int  1 ; 

if  (p  ptr  !=  MULL) 

{ 

If  (p_ptr->y  loc  !=  -9999) 

{ 

printf  ("\n  Port  *s  *c  ",  p_ptr->port_name,  p_ptr->port_layer ) ; 
printf  ("*d,%d  (ret,  E,  M,  or  D);  ",  p_ptr->x_loc,  p_ptr->y_loc); 
option  =  Get_0pt1on  (); 
if  (option  ==  'D' ) 
p_ptr->y_loc  =  -9999; 
else  if  (option  ==  'M' ) 

{ 

printf  ("\n  New  Port  Name:  "); 

1  =  0; 

while  ( (p_ptr->port_name  (1J  =  getc(O))  !=  ’\n')  ++1; 
p_ptr->port_name  (1)  =  '\0'; 

printf  ("\n  New  port  layer  \n“);  Def_Layer  (FALSE); 
p_ptr->port_layer  =  layer; 

printf  (''\n  New  X  Location  ;  ");  p_ptr->x_loc  =  Get_Num  (0); 
printf  ("\n  New  Y  Location  :  ");  P_ptr->y_loc  =  Get_Nura  (0); 


if  (option  !=  'E') 

) 


Mod_Port  (p_ptr->next_port); 


Nendlf 


#1fneed  Mod_Rect 


Mod_Rect  (exit,  location,  l_rect) 

Int  *exit,  location; 

struct  rectangle  *l_rect; 

( 

char  option; 

int  r_h,  r_l ,  r_x,  r_y; 


If  (1_rect  !=  NULL  &&  *ex1t  ==  FALSE) 

{ 

Mod_Rect  ( ex 1 1 , 1 ocat 1  on , ( 1  rect ) ->1 ess_than_x ) ; 

If  (*ex1t  ==  FALSE  &&  (location  <=  1_rect->x  location  ||  location  ==  0)) 

( 

printf  ("\nRect  H  *  *d,  L  =  *d,  ",l_rect->he1ght,  1_rect->1ength); 
printf  (”x,y  =  »d,  *d  1_rect->x_1ocat1on,  1_rect->y_1ocat1on); 
printf  ('*  (return,  E,  M,  or  0):  ”); 
option  *  6et_0pt1on  (); 


if  (option  ==  •£■) 

♦exit  =  TRUE; 
else  if  (option  ==  'M’) 

{ 

printf  ("\n  New  Height;  "); 

r_h  =  (l_rect)->he1ght  =■  Get_Mum  (0); 

printf  ("\n  New  Length:  ”); 

r_l  =  (1_rect)->1ength  =  6et_Huffl  (0); 

printf  (”\n  New  x  location;  “); 

r_x  =  Get_Nuni  (0); 

printf  (“\n  New  y  location:  “); 

r_y  =  l_rect->y_locat1on  =  Get_Num  (0); 

if  (r_x  !=  ]_rect->x_1ocation) 

{ 

1_rect->height  =  l_rect->length  =  0; 

if  (layer  ==  'F')  Rect_Tree  (r_h,  r_l ,  r_x,  r _y,  4f_rect); 


else  If  (layer 
else  if  Hayer 
else  if  (layer 
} 


•S')  Rect_Tree  (r_h. 
'D‘)  Rect_Tree  (r_h, 
•P*)  Rect_Tree  (r_h. 


r_y.  4s_rect); 
r Ji.  4d_rect); 
r_y.  4p_rect); 


else  if  (option  --  'O' ) 

1  rect->height  =  l_rect->length  =  0; 

} 

if  (♦exit  ==  FALSE) 

Hod  Rect  (exit,  location,  1  rect->equals_x); 
if  (♦exit  =»  FALSE) 

Mod  Rect  (exit,  location,  1_rect->greater  than  x); 
)  ■ 

} 

#endif 


V 


If  If  need  Mod_Wire 

^4r**>lr*«r***4r*A*yk**1t**4t**il[«r*4r**«**1ir4r4r***tit***4t4r*«r***4r1lt*4rtir4r**4r**4r****yir4r4c****4r 

*  Module  Maine:  Mod_W1re  * 

*  Module  Number:  3.3.3  * 

*  Version/Date:  1.0  11  August  1985  * 

*  Input  Parameters:  exit,  mod.  location,  ptr  * 

*  Output  Parameters:  exit  * 

*  Global s  Used:  seg  ptr.  wire_ptr,  layer  * 

*  Modules  Called:  Segment_Tree,  6et_0pt1on,  Get_Num,  * 

*  S_Mlre_Tree,  Place_M1re_Parameters  * 

*  Calling  Modules:  M_Implefflent  * 

*  Function:  Modify  an  existing  wire  * 

*  POL:  * 

*  If  a  wire  is  defined  at  this  location  and  exit  flag  Is  false  * 

*  Walk  the  left  wire  tree;  * 

*  It  exit  false  and  location  valid  and  wire  not  deleted  * 

*  Print  the  wire  parameters,  * 

*  determine  option  tor  this  wire,  * 

*  if  option  is  to  exit.  Set  exit  flag  to  true;  * 

*  else  if  option  is  to  modify  * 

*  Get  new  starting  x,y  location,  * 

*  If  the  new  x  =  the  old  x  location  * 

*  Display  and  change  segment  parameters  as  needed;  * 

*  else  * 

*  Place  new  wire  using  new  x  loc  with  old  segments,  * 

*  Delete  old  wire;  * 

*  else  if  option  is  to  delete  * 

*  Delete  this  wire’s  segments;  * 

*  if  not  exit.  Walk  the  middle  wire  tree;  * 

*  if  not  exit.  Walk  the  right  wire  tree.  * 

Mod_Wire  (exit,  location,  ptr) 
int  *ex1t,  location; 

struct  wire  *ptr; 

{ 

char  option,  temp_layer; 

int  new_x,  exit_seg; 

struct  wire_parameters  *seg; 
if  (ptr  !=  MULL  &&  *exit  ==  FALSE) 

{ 

Mod_Wi re  ( ex i t , 1 ocati on , ptr->w_1 _t_x ) ; 

if  (*exit  ==  FALSE  &&  (location  <=  ptr->w_x_l ocati on  ||  location  ==  0) 
&&  ptr->w_param  !=  NULL) 

{ 

printf  ("\nW1re  x,y  =  *d,  *d",  ptr->w_x_I ocati on,  ptr->w_y_location) ; 

Segment_Tree  (0,  ’  ',  ptr->w_param); 

printf  ("\n\t  (return,  E,  M,  or  D):  "); 

option  =  Get_0ptlon  (); 

if  (option  ==  'E' ) 

♦exit  =  TRUE; 
else  if  (option  ==  'M' ) 

{ 


printf  ("\n  New  x  location;  "); 
new_x  =  Get_Num  (0); 
printf  (“\n  New  y  location:  "); 
ptr->w _y_locat1on  =  Get_Num  (0); 

If  (new_x  ==  ptr->w_x_1ocat1on) 

{ 

seg  =  ptr->w_param; 
exit  seg  =  FALSE; 

while  (seg  NULL  M  ex1t_seg  FALSE) 

( 

printf  ("*c  M*d  »c“,  seg->w_1ayer,..eg->w1dth,seg->d1rect1on); 
printf  (“*d  (return,  E,  or  M):  seg->1ength); 

option  =  Get_0pt1on  (); 

If  (option  ==  'E' ) 
exit_seg  =  TRUE; 
else  If  (option  ==  'M' ) 

( 

printf  ("\nNew  width  :  “); 
seg->w1dth  =  Get_Nuin  (0); 
printf  ("\nNew  length  ;  “); 
seg->1ength  =  Get_Nuin  (0); 
printf  ("XnNew  Layer"); 

Def_Layer( FALSE); 
seg->w_layer=  layer; 

seg  »  seg->next  segment; 

> 

} 

else 

{ 

S_Wire_Tree  (new_x,  ptr->w _y_locat1on,  &w1re_ptr); 

seg  =  ptr->w_param; 

ptr->w_param  =  NULL; 

temp_layer  =  layer; 

while  (seg  !=  NULL) 

( 

layer  =  seg->w_layer; 

P lace_W1re_Parametr(seg->w1dth,seg->length,seg->dl recti  on, seg_ptr); 
seg  =  seg->next  segment; 

} 

layer  =  temp_layer; 

} 

) 

else  If  (option  ==  ’O')  ptr->w_param  =  NULL; 

) 

It  (-exit  =*  FALSt) 

Mod_W1re  (exit,  location,  ptr->w_e_x); 

IT  ("exit  =»  FALbt) 

nod_Mire  (exit,  location,  ptr->w_g_t_x); 

> 

) 

Nendit 


nodule  Name:  nod_Via 

nodule  Number:  3.3.4 

Verslon/Uate:  l.U  11  August  198b 

Input  Parameters:  exit,  mod,  location,  1_v1a 

Uutput  Parameters:  none 

Globals  Used:  s_v1a.  p_v1a,  d_v1a 

nodules  Called:  Get_Qpt1on.  Get_Num.  V1a_Tree 

Calling  Hodules:  n_Imp1efflent 

Function:  Hodlfy  an  existing  Via 

POL: 

If  a  via  Is  defined  at  this  location  and  exit  flag  Is  false 

Malk  the  left  via  tree; 

If  not  exit  and  location  valid  and  via  not  deleted 
Print  via  location. 

Determine  option. 

If  option  Is  to  exit 
Set  exit  flag  to  true; 
else  If  option  Is  to  modify 
Get  new  x.y  location. 

If  new  X  does  not  =  old  x 
Place  a  via  with  new  x.y. 

Delete  old  via; 
else  If  option  Is  to  delete 
Delete  via; 

If  not  exit 
Walk  middle  via  tree; 

If  not  exit 
Walk  right  via  tree. 


* 

* 

* 

* 

* 

•k 

* 

* 

it 

it 

it 

it 

it 

it 

* 

* 

Hr 

* 

Hr 

* 

Hr 

Hr 

Hr 

Hr 

Hr 

Hr 

* 

Hr 

Hr 

Hr 


Mod_V la  (exit,  location,  1 _v 1  a ) 

Int  *ex1t,  location; 

struct  via  *l_v1a; 

{ 

char  option; 

1  nt  new_x; 

if  (l_via  !=  MULL  6&  *exit  ==  FALSE) 

{ 

Mod_V1a  (exit,  location,  l_v1a->v_l_t_x) ; 
if  (*ex1t  *=  FALSE  &&  location  <=  l_v1a->v_x_location 
U  l_v1a->v _j  location  !=  -9999) 

{ 

printf  ("\nV1a  x.y  =  %d,  %d  ",  ]_v1a->v_x_locat1on,  l_v1a->v _y_locat1on) 
printf  ("  (return,  E,  M,  or  D):  ”); 
option  =  Get  Option  (); 


If  (option  ==  'E') 

*ex1t  =  TRUE; 
else  if  (option  ==  ‘M* ) 

{ 

printf  ("\n  Mew  x  location;  "); 
new_x  =  Get_Num  (0); 
printf  ("Xn  New  y  location: 
l_v1a->v _y_locat1on  *  Get_Nuni  (0); 

If  (new_x  !=  I_v1a->v  x_locat1on) 

{ 

If  (layer  »=  'S')  V1a_Tree  (new_x,  l_v1a->v _y_locat1on,  &s_v1a); 
else  If  (layer  ==  '0')  Vla_Tree  (new_x,  l_v1a->v_y_location.  4d_vla); 
else  If  (layer  ==  'P')  V1a_Tree  (new_x.  I_v1a->v _y_locat1on,  &p_v1a); 
l_via->v_y  location  =  -9999; 

> 

else  if  (option  ==  'O' ) 

l_v1a->v_y_location  =  -9999; 

> 

If  (*exit  ==  FALSE) 

Mod_V1a  (exit,  location,  1  v1a->v_e_x); 

If  (*exlt  ==  FALSE) 

Mod  Via  (exit,  location,  1  v1a->v_g_t_x); 

) 

} 

Mendlf 
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#1fneed  Mod_Flash 

^********lHk*************<t*****»**»***r*1lt*l«t*****1lt*^*****1lr***************** 


* 

it 

* 

Hodule  Name:  Hod_F1ash 

Hr 

it 

Hodule  Number:  3.3.5 

Hr 

* 

Verslon/Oate:  1.0  11  August  1985 

Hr 

* 

Input  Parameters:  none 

Hr 

* 

Output  Parameters:  none 

* 

* 

Global s  Used:  none 

* 

★ 

Modules  Called:  none 

* 

* 

Calling  Modules:  M_Imp1ement 

★ 

Hr 

Function:  Modify  round  flashes 

★ 

* 

POL: 

it 

Hr 

Hr 

★★★jlrJlf*#*»***ilrjmf***^**********llr*<rl»****************1»r**r*******lHlr****llr**1Hlr**y 

Mod_F1ash  ( ) 


{ 

printf  ("\n  Mod_F1ash  not  yet  coded  \n“); 

> 


Mendlf 


* 

it 

* 

Program  Name:  INTER. C 

it 

* 

it 

Version/Date:  1.0  18  September  1985 

it 

* 

it 

Function:  This  subprogram  to  HOCLL.C 

does  nothing  right  now 

* 

it 

but  Mill  eventually  allow  the 

user  to  Interconnect 

* 

it 

it 

already  existing  cells. 

* 

* 

* 

Include  Files  Needed:  HOCLL.H  (which 

Includes  tprintf.c. 

it 

★ 

exec.c.  and  all  global  variables  needed  In  the 

n 

★ 

* 

mdcll  system) 

it 

it 

it 

it 

Program  Hierarchy: 

it 

it 

it 

it 

4.0  INTER  Hain 

1 

it 

it 

it 

it 

1 

1 - 0.0*  MDCLL  Main 

* 

* 

-.Jl 


#1nc1ude  “mdcl 1 .h 


^Hr>»*******#********illf**1lt****Klt******<t**HtHt********5Hlrimr>lr1lr1lrllr*>lnimrHri»r******>lr***** 


* 

* 

Module  Name:  Main 

it 

it 

Module  Number:  4.0 

* 

it 

Version/Oate:  1.0  18  September  1985 

it 

it 

Input  Parameters:  none 

it 

★ 

Output  Parameters:  none 

if 

* 

Globa  Is  Used:  none 

* 

★ 

Modules  Called:  none 

it 

* 

Calling  Modules:  MOCLL  program 

it 

it 

Function:  Eventually  interconnect  already  placed  cells 

it 

it 

POL: 

it 

it 

Print  message; 

it 

★ 

★ 

Return  to  MOCLL. 

it 

it 

★♦★llr**********************#***********************************!^*********  ! 

tna1n( ) 

{ 

printf  ("\n\n  INTER  Subprogram  not  yet  1mplefflented\n\n\n" ) ; 

printf  {"\n\n  To  Interconnect  cells  use  the  modify  subprogram  "); 

printf  ("\n  to  place  wire  statements,  vias.  etcAn"); 

printf  ("\n\n  Hit  return  to  continue:  “); 

while  (getc(O)  !=  '\n' ): 

exec  ("M0CLL“,  "N"); 


Ii(iti(i(i(iti(ifi(i(i(iri('k'kic'ki(icit'kitici(i(it'kici(i(icititicit'k’kft'i(iciticiti(ic'kicitit1ci(ititiei(iti(ici(icicitiri(itifi(iri[itif'k 
it  it 


Nodule  Name:  Main 
Nodule  Number:  5.0 

Version/Date:  1.0  18  September  1985 

Input  Parameters:  none 
Output  Parameters:  none 
Globa Is  Used:  none 

Nodules  Called:  Name_Cell.  In_Flle.  Get_0pt1on 
Calling  Nodules:  NDCLL  program 
Function:  Print  an  already  existing  CIF  cell 
POL: 

While  not  finished 

Name  the  cell  to  be  printed; 

If  not  found  on  disk 
If  shouldn't  try  search  for  file  again 
Set  finished  to  true; 

else 

Set  finished  to  true. 

Send  the  file  to  the  terminal  one  line  at  a  time. 


* 

* 

* 

* 

* 

* 

* 

■k 

•k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 
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main( ) 

{ 


int 


finished, 
on  disk. 


char  option, 

cel 1name(151 . 
fi  lenameilZ] , 
string[801 ; 

FILE  *fopen(),  *fp; 

printf  ( "\n\n\n\n\n\n\n\t\t  READY  TO  PRINT  A  CELL  \n\n\n\n\n\n" ) ; 

finished  =  FALSE; 

while  (finished  ==  FALSE) 

{ 

printf  ( "\n  Enter  Name  of  cell  to  be  printed:  "); 

NameCell  (&on  disk,  filename,  cellname); 
if  (on_disk  ==~FALSE) 

( 

printf  ( "\n  Can't  find  filename  %s;  try  again  (return  or  N):  ",  filename) 
if  (Get_0ption  ()  !=  '\n’) 
finished  =  TRUE; 


else 

{ 

finished  =  TRUE; 

fp  =  fopen  (filename,  "r"); 

while  (stringlOl  !=  'E'  &&  option  !=  'E') 

{ 

In_Flle  (fp,  ‘\n',  string): 

printf  ("*s  \n'', string); 

if  (i  >  19  II  string  [0]  ==  ‘E') 

( 

printf  ("\n\n  Hit  Return  to  Continue  or  E  to  exit:  ''); 
option  =  Get_Qption  (); 
if  (option  !=  '\n' ) 
option  =  'E‘ ; 
i  =  1; 

) 

else  ++1 ; 

} 

fclose  (fp); 

> 

) 

exec  ("MDCLL",  “N“); 

) 

#include  "dpmlib. 1 ib" 

#include  "creSI ib. 1 ib" 

#include  "savel ib. 1 ib" 

^include  "stdlib.c" 


ftc-kliltitiritirieicleitit*********************************************************** 


Program  Name;  FINALIZE.C 

Version/Date:  1.0  5  September  1985 

Function;  This  subprogram  to  MOCLL.C  Is  used  to  manipulate 
already  existing  basic  cells  to  arrange  them  Into 
a  single  GIF  file. 

Library  Files  Needed;  NOCLL.H  (which  Includes  tprintf.c 
exec.c,  and  all  global  variables  needed  In  the 
MOCLL  system).  CLIB.C.  MLIB.C,  SAVELIB.C  and  STDLIB.C. 

Program  Hierarchy; 

6.0  FINALIZE  Main 


-  1.1*  Name_Cell 

-  2.1.1*  In_F11e 

-  2.1.6*  Get_Call 

-  2.1.7*  Get  Iter 


-  6.1  Format  Clf 


-  6.l.lr  Pr1mary_Calls 

1 - 6.1.1.1r  Call_Names 

-  6.1.2r  Iter_Calls 

1 - 6. 1.1.1*  Call_Names 

-  6.1.3  Process_Call 

I - 1.2.1*  Get_0pt1on 

I - 2.1.1*  In_Fne 

I - 7.2.1*  0ut_F11e 

1 - 6. 1.1.1*  Ca11_Names 

I - 7.1*  Oet_Cifnum 

-  2.1.1*  In_F11e 

-  7.2.1*  Out  File 


-  1.2.1*  6et_0pt1on 

-  0.0*  MDCLL  Main 


^include  "mdcll.h" 


Jifificifitifiticicititicititicicicitir'kititic'kit'kititicicitititicit'kirititit'k'kitit'kie'kiticitic'kifititit'kititicifit'kitiriritifititific 


ic 

* 

■k 

Module  Name;  Main 

* 

k 

Module  Number;  6.0 

k 

k 

Version/Date;  1.0  5  September  1985 

k 

k 

Input  Parameters;  none 

k 

k 

Output  Parameters;  none 

k 

k 

Global s  Used;  none 

k 

k 

Modules  Called;  Name  Cell,  Get  Option,  Get  Call, 

Format_C1f , 

k 

k 

In_File.  Get_Iter,  MOCLL  Main 

k 

k 

Calling  Modules;  MOCLL  program 

k 

k 

Function;  Format  all  needed  CIF  for  one  circuit 

into  one  file 

k 

k 

PDL; 

k 

k 

While  filename  not  found 

k 

k 

Name  the  cell  to  be  finalized; 

k 

k 

If  file  found  on  disk 

k 

k 

Open  the  file. 

k 

k 

While  not  finished  reading  the  file 

k 

k 

Get  all  the  cell  names. 

k 

k 

Close  the  file. 

k 

k 

Format  the  final  CIF; 

k 

k 

else 

k 

k 

If  don't  want  to  search  disk  for  another  filename 

k 

k 

Say  the  filename  was  found  to  exit  loop; 

k 

k 

Execute  MOCLL. 

k 

k 

k 

main  ( ) 

{ 

int  on_d1sk, 

f inished_reading; 

char  filename  [12], 

ceilname  [15], 
string  [80]; 

FILE  *fopen(),  ’*^fp; 

printf  ( "\n\n\n\n\n\n\n\t\t  READY  TO  FINALIZE  A  CELL  \n\n\n\n\n\n\n‘‘ ) ; 

on_d1sk  =  FALSE; 

while  (on_d1sk  ==  FALSE) 

[ 

printf  (‘'\n  Enter  name  of  cell  to  be  finalized;  "); 

Name_Cen  (&on_d1sk,  filename,  ceilname); 

If  (on_d1sk  ==  TRUE) 

[ 

fp  =  fopen  (filename,  “r"); 
f 1n1shed_read1ng  =  FALSE; 


while  (f1nished_read1ng  ==  FALSE) 

{ 

In_Fne  (fp,  '\n' .  string); 

If  (string  10]  ==  '{'  &&  string  [1]  ==  'S'  &&  string  [2] 
&&  string  [3]  ==  'A*  ) 

If  (string  (7)  ==  'C* ) 

Get.Call  (fp,  string); 
else  If  (string  [7]  ==  ' I* ) 

Get_Iter  (fp,  string); 

) 

else  If  (string  (0]  ==  ’E’ ) 
f1n1shed_read1ng  =  TRUE; 

> 

fclose  (fp); 

Forma t_C if  (filename,  cell  name); 

} 

else 

printf  ("\n  Can't  find  file  *s;  Try  again  (ret  or  N):  "); 
if  (Get_0pt1on  ()  !=  '\n') 
on  disk  =  TRUE; 

} 

} 

exec  ("MDCLL",  “N"); 

) 


#1nclude  "final  1 1b. 1 ib" 
#1nc1ude  "dpmlib.llb" 
^Include  "modllb.llb" 
^Include  "creSl 1b. 1 1b" 
minclude  "savel ib. 1 ib" 
#1nc1ude  "stdllb.c" 
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Module  Name:  Format_Cif 

Module  Number:  6.1 

Version/Date:  1.0  5  September  1985 

Input  Parameters:  filename,  cell  name 

Output  Parameters:  none 

Globals  Used:  cal1_ptr.  iter_ptr 

Modules  Called:  Pr1mary_Cal1s,  Process_Ca1 1 .  Iter_Cans 
Calling  Modules:  FINALIZE  Main  (6.0) 

Function:  Format  CIF 
POL: 

Open  the  file  final. clf; 

Load  the  primary  calls  Into  the  secondary  call  tree; 
While  there  are  more  secondary  calls 
Process  the  calls; 

Reopen  the  file  being  finalized; 

Copy  the  file  to  final. clf  one  line  at  a  time; 

Close  both  files. 


* 

* 

* 

■k 

* 

* 

* 

•k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 
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Format_C1f  (filename,  cell  name) 


char  *filename,  *ce11name; 

{ 

Int  finished; 

char  a_c1fnum  (7],  string  (80]; 

FILE  *fopen(),  *fpl.  fp2; 

struct  cal1ed_ce11s  *scptr; 

fpl  =  fopen  ("final .clf",  "w"); 

Primary_Cal is  (call_ptr); 

Iter_Ca11s  {1ter_ptr); 
scptr  =  s_cal1s; 
while  (scptr  !=  NULL) 

{ 

Process_Ca11  (scptr->cellname,  fpl); 
scptr  =  scptr->next_cal 1 ; 

) 

fp2  =  fopen  (filename,  "r"); 

finished  =  FALSE; 

while  (finished  ==  FALSE) 

{ 

In_File  (fp2,  '\n',  string); 

0ut_F11e  (string,  "\n",  fpl); 
if  (string  [0]  ==  'E')  finished  =  TRUE; 
} 

fclose  (fp2); 
fclose  (fpl); 

) 


255 
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*  Module  Name:  Primary_Cal 1 s  * 

*  Module  Number:  6.1.1  * 

*  Version/Oate:  1.0  5  September  1985  * 

*  Input  Parameters:  cptr  * 

*  Output  Parameters:  none  * 

*  Globa )s  Used:  s_calls  * 

*  Modules  Called:  Cal1_Names,  Prlmary_Calls  (recursion)  * 

*  Calling  Modules:  Format_Clf,  Prlmary_Cal 1 s  * 

*  Function:  Get  all  the  called  cells  names.  * 

*  POL:  * 

*  If  the  location  Is  defined  * 

*  Malk  the  left  call  tree;  * 

*  Extract  the  called  cells'  names  and  clfnums;  * 

*  Walk  the  right  call  tree.  * 

*  * 


Prlmary_Cal 1 s  (cptr) 
struct  cal l_statement  *cptr; 


If  (cptr  !=  NULL) 

{ 

Prlmary_Cal Is  (cptr->l_t_name) ; 

Call_Names  (cptr->cel  Inariie,  cptr->clfnum,  &s_calls); 
Primary  Calls  (cptr->g  t_name); 

) 
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*  * 

*  Module  Name:  Ca11_Nanies  * 

*  Module  Number:  6.1. 1.1  * 

*  Version/Date:  1.0  5  September  1985  * 

*  Input  Parameters:  cell  name,  cifnum,  scptr  * 

*  Output  Parameters:  none  * 

*  Globals  Used:  none  * 

*  Modules  Called:  Call_Names  (recursion)  * 

*  Calling  Modules:  Ca11_Names,  Pr1mary_Cal Is,  Process_Call  * 

*  Function:  Places  all  calls  not  previously  defined  In  the  * 

*  called  cells  tree  * 

*  POL:  * 

*  If  location  Is  not  defined  (call  not  a  duplicate)  * 

*  Allocate  memory,  * 

*  Store  the  cell  name  and  cifnum;  * 

*  else  * 

*  If  the  called  cell’s  name  is  not  already  stored  * 

*  Check  the  next  call.  * 

*  * 

A***********************************************************************  j 

Call_Names  (cellname.  cifnum.  scptr) 

char  *cel1name; 

Int  cifnum; 

struct  called_cells  **scptr; 


If  (*scptr  ==  MULL) 

( 

*scptr  =  alloc  (sizeof  (struct  called_cells)); 

{♦scptr )->next_cal 1  =  NULL; 

1  =  0; 

while  ( ( (*scptr )->cel lname(1 ]  =  cel1name{1])  !=  '\0')  ++i; 
(♦scptr )->cifnum  =  cifnum; 

) 

el  se 

if  (cifnum  !=  (♦scptr)->cifnum) 

Call_Names  (cellname,  cifnum,  &{^scptr )->next_cal 1 ) ; 

) 


*  ^  • 
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Module  Name:  Iter_Calls 

* 

Hr 

Module  Number:  6.1.2 

* 

Hr 

Verslon/Oate:  1.0  18  September  1985 

* 

* 

Input  Parameters:  Iptr 

* 

* 

Output  Parameters:  none 

* 

* 

Global s  Used:  s_ca11s 

* 

* 

Modules  Called:  Cal1_Names.  Iter_Cal1s  (recursion) 

* 

* 

Calling  Modules:  Format_cif.  Iter_Ca11s 

He 

* 

Function:  Get  all  the  Iterated  cells  names. 

He 

* 

POL: 

He 

★ 

If  the  location  Is  defined 

He 

He 

Walk  the  left  Iter  tree; 

He 

He 

Extract  the  Iterated  cells'  names  and  cifnums; 

He 

He 

He 

Walk  the  right  iter  tree. 

He 

He 

Iter_Cal1s  (Iptr) 

struct  i ter_statement  *1ptr; 

( 

if  (iptr  !=  MULL) 

{ 

Iter_CalJs  ( iptr->}_t_cifnum); 

Ca11_Names  ( 1ptr->celTname,  iptr->c1fnum,  &s_cans); 
Iter  Calls  (1ptr->g  t  cifnun); 


f*************************************************!^********************** 


Module  Name:  Process_Ca11 
Module  Number:  6.1.3 
Version/Oate:  1.0  5  September  1985 

Input  Parameters:  cell  name,  fpl 
Output  Parameters:  none 
Globa Is  Used:  s_cal1s 

Modules  Called:  6et_0ption,  In_F11e,  Out_File,  Call_Names, 
Oet_Cifnum 
Calling  Modules:  Format_C1f 
Function:  Copy  called  cells  file  an  ensure  no  files  are  missed  * 

* 

* 
* 
* 
* 
it 


PDL: 

Obtain  the  filename  from  the  cell  name; 
While  not  finished 
Open  the  file. 

Copy  a  line  to  final. clf. 

If  the  line  Is  a  call  statement 


Add  the  call  to  the  called  cells  tree. 


* 

* 


ilr***************^*******************************************************  j 

Process_Ca11  (cell name,  fpl) 


char 

FILE 


*cel Iname; 
*fpl; 


{ 

Int 

char 

FILE 


1,  j,  finished; 
filename  (20),  string 
*fopen  (),  *fp2; 


(801; 


1  =  0; 

while  ((filename  (ij  =  cellname  (11)  !=  '\0' )  ++1; 

filename  (1++1  = 

filename  (i++l  =  'C; 

filename  [1++1  =  'I'; 

filename  (i++j  =  ’F’; 

filename  [11  =  '\0'; 

finished  =  FALSE; 

while  (finished  ==  FALSE) 

{ 

fp2  =  fopen  (filename,  "r"); 
if  (fp2  ==  NULL) 

( 

printf  ("\n  Can't  find  file  *s;  Try  again  (ret  or  N):  ",  filename); 
If  (Get  Option  ()  !=  'Nn')  finished  =  TRUE; 


while  (finished  ==  FALSE) 

{ 

In_File  (fp2.  '\n',  string); 
prlntf  (“*s\n",  string); 

Out  File  (string,  "\n",  fpl); 

if  Tstring[OJ  =»  'O'  U  strlngdJ  ==  ’F'  &&  stringI2]  ==  •;*) 

{ 

Out_File  (”\n\n".  "\n\n”.  fpl); 
finished  =  TRUE; 

> 

else  If  (string  [01  ==  •('  &&  (string  [1]  ==  ’C  1 1  string  [1] 

{ 

1=6;  j  =  0; 

while  ((cellname  [J++1  “  string  I1++1)  !=  '  '); 
cellname  [jl  =  ‘\0'; 

Ca11_Names  (cellname,  Oet_Clfnum  (cellname),  &s_calls); 


fliiili-itiili-kiili-kitiiltitlilcititiiltic-kilililitit***************************:****************** 

*  Program  Name;  SAVECELL  * 

*  Version/Oate:  1.0  29  August  1985  * 

*  Function;  This  subprogram  in  the  HOCLL  system  is  used  to  * 

*  save  the  cells  to  disk.  * 

*  Library  Files  Heeded;  MOCLL.H,  SAVELIB.C.  STDLIB.C  * 

*  Program  Hierarchy;  * 

*  7.0  SAVECELL  Main  * 

*  I  * 

*  I - 7.1  Oet  Cifnum  * 

*  I  * 

*  I - 7.2  Header  Out_File  * 

*  I  I - 7.2.1  Out_File  * 

■k  I  * 

*  I - 7.3  Out_Cell_Layout  * 

*11  * 

*  1  I - 7.2.1*  Out_File  * 

*11  * 

*  I  I - 7.3. Ir  Out  Port_Tree  * 

*  I  I  I - 7.2.1*  Out_File  * 

*11  * 

*  I  I - 7.3.2r  Out  Rect_Tree  * 

I  I  I - 7.2,1*  Out_File  * 

*11  * 

*  1  I - 7.3.3r  Out  Mire_Tree  * 

*  I  I  I - 7.2,1*  Out_File  * 

*  I  I  I - 7.3.3. Ir  Out_M  Comment  * 

*  I  I  I - 7.2.1*  Out_File  * 

*  I  I  I - 7.3.3.2r  Out  W  Segment  * 

*  I  1  I - 7.2.1*  Out_F11e  * 

*  1  I  I - 1.3. 2.1*  Rect  Tree  * 

*  I  I  I - 1.3.4. 1*  Via_Tree  * 

*11  * 

*  I  I - 7.3.4r  Out_Via_Tree  * 

*  I  I  I - 7.2.1*  Out_Fi1e  * 

*11  * 

*  1  I - 7.3.5r  Out  Cal l_Tree  * 

*  I  I  1 - 7.2.1*  Out_File  * 

*  1  I  I - 7.3.5. 1  Out_C_Statement  * 

*  II  I  I - 7.2.1*  Out_File  * 

*  1  I  I - 7. 3. 5, 2  Out_P_Names  * 

*  I  I  I - 7.2.1*  Out_File  * 

*11  * 

*  I  I - 7.3.6r  Out_lter_Tree  * 

*  I  1 - 7.2.1*  Out_File  * 

*  1  I - 7.3.5. 1*  Out_C_Statement  * 

*  I  I - 7. 3.5.2*  Out_P_Names  * 

*  1  * 

*  I - 7.4  Footer  Out_File  * 

*  I  I - 7.2T1*  Out_File  * 

*  I - 0.0*  MUCLL  Main  * 

********★******★♦*★**#»*★************♦****************★**★***★******★**★/ 


# include  "mdcl I .h" 

*  Module  Name:  Main  * 

*  Module  Number;  7.0  * 

*  Version/Date:  1.0  29  August  1985  * 

*  Input  Parameters:  argument  list  containing  filename,  * 

*  cellname,  and  all  the  pointers  for  the  cell  to  be  saved  * 

*  Output  Parameters;  none  * 

*  Globals  Used:  port_ptr,  f_rect.  s_rect,  p_rect,  d_rect,  s_v1a  * 

*  P_v1a,  d_v1a,  w1re_ptr,  call_ptr,  lter_ptr  * 

*  Modules  Called;  Det_C1fnum,  Header_0ut_F11e,  0ut_Cel l_Layout  * 

*  Footer_0ut_F11e,  MOCLL  Main  * 

*  Function:  Save  the  clf  file  to  disk  * 

*  POL:  * 

*  Convert  the  pointers  for  the  cell  to  be  saved;  * 

*  Determine  the  cifnum;  * 

*  Open  the  file;  * 

*  Output  the  CIF  file  header;  * 

*  Output  the  CIF  cell  layout;  * 

*  Output  the  CIF  file  footer;  * 

*  Close  the  file;  * 

*  Execute  MOCLL.  * 

main  (argc.  argv) 

Int  argc; 

char  *argv(]; 

( 

char  f 1 lename[19] ,  cel InametlS] ,  a_c1fnuml7); 

Int  cifnum,  1,  j; 

FILE  *fopen(),  *fp; 

1=0;  j  =  1; 

while  ({fllenamelll  =  argv[j][1])  !=  '\0’ )  ++1 ; 

1  =  0;  ++j; 

while  ( (cel lname[1 ]  =  argvljllll)  !=  '\0')  ++i; 
port_ptr  =  atol  (argv  [++jl); 

f_rect  =  atol  (argv(++jl);  s_rect  =  atol  (argv(++jj); 
d_rect  =  atol  (argv(++jj);  p_rect  =  atol  (argvi++j]); 
s_v1a  =  atol  (argv(++j});  d_v1a  =  atol  (argv[-*-+jJ ); 
p_v1a  =  atol  (argv(++ji);  w1re_ptr  =  atol  (argv(++j]); 
call_ptr  =  atol  (argv(++jl);  lter_ptr  =  atol  (argv(++jj); 
cifnum  =  DetCIfnuffl  (cellname); 
itoa  (cifnum,  a_cifnum); 
fp  =  fopen(f1 lename,  "w"); 

Header_0ut_F11e  (cellname,  a_c1fnum,  fp); 

0ut_Cel l_Layout  (fp); 

Footer_0ut_F1 le  (cellname,  a_c1fnum,  fp); 

fclose  (fp); 

exec  ("mdcll",  ”M"); 

1 

Ninclude  "save! 1b. 1  lb" 

Ninclude  "cre81 1b. 1 1b" 

Ninclude  "stdilb.c" 


'A 
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#ifneed  Oet_Cifnum 


» 

it 

it 

it 

it 

it 

it 

it 

* 

it 

it 

it 

it 

it 

it 

it 
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Module  Name;  Det_C1fnum 
Module  Number:  7.1 
Version/Date:  1.0  25  July  1985 
Input  Parameters;  cell  name 
Output  Parameters:  cifnum 
Global s  Used;  none  . 

Modules  Called;  none 

Calling  Modules:  SAVECELL  Main,  0_Imp1ement,  Process_Ca11 
Function;  Determine  the  CIF  number  based  on  the  cell  name 
PDL: 

Compute  cifnum  from  characters  and  their  position; 

If  calculated  cifnum  Is  negative 


Make  It  positive; 
Ensure  the  cifnum  Is 
Return  the  cifnum. 


greater  than  1000. 


* 

* 

★ 

* 

■k 

* 

* 

* 

★ 

* 

■k 

k 

k 

k 

k 

k 
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Oet  CIfnum  (cell name) 
char  *cel1name; 

{ 

Int  1 , 

cifnum; 

1  =  0; 
cifnum  =  0; 

while  ( (cel  1  name! 1 ]  !=  '\0' )  &&  (cellnamell)  !=  '\n')) 

{ 

cifnum  =  10  *  cifnum  +  cellnamefi]  -  'O'; 

++i; 

) 

If  (cifnum  <  0) 
cifnum  =  cifnum  *  -1 ; 
cifnum  =  cifnum  +  1000; 
return  (cifnum); 

) 


#ifneed  Header_0ut_F1 le 

^i(icit*iiti(i(iciriciti(ici('kiticiticicicicitititirieiei(ititicicititiciticitic'kicicfciciticifit'ki(icic'k'k'kicitic'k'k'k'kic'kicitftitic1c 


* 

* 

* 

Module  Name;  Header_Out_Fi le 

* 

it 

Nodule  Number:  7.2 

* 

* 

Version/Date:  1.0  28  July  1985 

★ 

* 

Input  Parameters;  cellname,  a_cifnum,  fp 

* 

★ 

Output  Parameters;  none 

* 

* 

Globa Is  Used;  SCALE_A,  SCALE_B 

* 

* 

Modules  Called;  0ut_F11e 

it 

* 

Calling  Modules;  Main  (7.0) 

it 

* 

Function;  Print  the  CIF  file  header 

it 

* 

it 

POL;  N/A 

it 

it 

Header_Out  File  (cell name,  a_c1fnuin,  fp) 

FILE  *fp; 

{ 

printf  ("Initializing  cell  *s\n“,  cellname); 
Out_File  ("OS",  "  ",  fp); 

Out  File  (a_cifnutn.  "  ",  fp); 

Out  File  (SCALE  A,  "  ",  fp); 

Out  File  (SCALE  B,  ";\n",  fp); 

Out_File  ("(TITLE",  "  ",  fp); 

Out_File  (cellname,  "  ",  fp); 

Out_F11e  (a_cifnum,  ");\n",  fp); 


Hendif 


#ifneed  OutFile 


it 

it 

it 

* 

★ 

it 

it 

it 

it 

* 

it 

it 

it 

it 


Nodule  Name:  Out_Fne  * 

Module  Number:  7.2.1  * 

Version/Date:  1.0  27  July  1985  * 

Input  Parameters:  string,  separator,  fp  * 

Output  Parameters:  none  * 

Globa  Is  Used:  none  * 

Modules  Called:  none  * 

Calling  Modules:  Header_0ut_F1 le.  0ut_Cel l_Layout.  * 

Out_Port_Tree.  Out_Halk_Tree,  0ut_Cal 1_Tree  * 

0ut_F1 1e_Footer.  Process_Ca1 1 .  Format_Clf,  * 

Out_C_Statement.  Out_P_Mames  * 

Function:  Output  strings  to  the  disk  * 

POL:  N/A  * 

* 


***ilr*************1lr****llr**<tillr****»1lf*i»llr*llr*llt***1lr>lfl»rinnmt***********imri»*****llt**  j 


0ut_F11e  (String,  separator,  fp) 
register  char  ^string, 

■^separator; 
register  FILE  *fp; 

{ 

register  Int  c; 

while  (c  =  *string++) 
putc  (c,  fp); 
while  (c  =  *separator++) 
putc  (c,  fp); 

} 


Nendlf 


#1fneed  Out_Cel l_Layout 

^**************'*****'*#*»****1Hlr**Hr****lHlt****************llr****1lt***llr#<r*****jlt 

*  Module  Name:  Out_Cen_Layout  * 

*  Module  Number;  7.3  * 

*  Version/Date;  1.0  28  July  1985  * 

*  Input  Parameters;  fp  * 

*  Output  Parameters:  none  * 

*  Globa Is  Used:  port_ptr,  f_rect,  s_rect,  p_rect.  d_rect,  s_v1a,  * 

*  P_v1a,  d_v1a,  wire  ptr,  call_ptr,  iter  ptr,  M_VIA_SIZE.  * 

*  M2_VIA_SIZE.  C  VIAIsIZE,  D_VIA  SIZE.  pIvIA  SIZE.  * 

*  V_VIA_SIZE  * 

*  Modules  Called;  0ut_F11e.  Out_Port_Tree.  Out_Rect_Tree.  * 

*  0ut_M1re_Tree.  0ut_V1a_Tree.  Out_Can_Tree.  * 

*  Out_Iter_Tree  * 

*  Calling  Modules;  Main  (7.0)  * 

*  Function:  Output  the  complete  cell  layout  to  disk  * 

*  POL :  * 

*  If  there  are  ports  defined  * 

*  Output  the  ports;  * 

*  If  there  are  rectangles  defined  * 

*  Output  the  rectangles;  * 

*  If  there  are  wires  statements  defined  * 

*  Output  the  wire  statements  in  comments.  * 

*  Output  the  rectangles  defining  the  wires,  * 

*  Output  the  vias  defining  the  wires;  * 

*  If  there  are  vias  defined  * 

*  Output  the  vias;  * 

*  If  there  are  call  statements  defined  * 

*  Output  the  call  statements;  * 

*  If  there  are  Iterate  statements  defined  * 

*  Output  the  iterations.  * 

♦★★★★★★★★•tr**************************************************************  I 

OutCel l_Layout  (fp) 

FILE  np; 

{ 

printf  ("NnlSTART  PORT  DEFINITIONS);"); 

Out_Fi)e  ("\n(START  PORT  DEFINITIONS);".  "\n".  fp); 
if  {port_ptr  !=  NULL) 

Out_Port_Tree  {port_ptr,  fp); 

Out_File  {"(END  PORT  DEFINITIONS);".  "\n".  fp); 
printf  ("\n(START  RECTANGLE  DEFINITIONS);"); 

Out_File  ("\n( START  RECTANGLE  DEFINITIONS);".  "\n".  fp); 
if  (f_rect  !=  NULL) 

1 

Out_File  (“(rectangles  in  first  level  metal);",  "\nL  CM;\n",  fp); 
Out_Rect_Tree  (f_rect,  fp); 

) 

if  (s_rect  !=  NULL) 

( 

Out_File  ("(rectangles  in  second  level  metal);",  "\nL  CM2;\n",  fp); 
Out_Rect_Tree  (s_rect,  fp); 

1 


if  (d_rect  !=  MULL) 

{ 

Out_File  ("(rectangles  in  diffusion);".  "\nL  CD;\n",  fp); 
Out_Rect  Tree  (d_rect,  fp); 

} 

if  (p_rect  !*  MULL) 

( 

Out_File  ("(rectangles  in  polysilicon);",  “\nL  CP;\n",  fp); 
Out_Rect_Tree  (p_rect.  fp); 

) 

Out_File  (-(END  RECTANGLE  OEFIMITIOMS);".  "\n".  fp); 
printf  ("\n(START  MIRE  DEFINITIONS);"); 

0ut_Fi1e  ("\n(START  MIRE  DEFINITIONS);".  "\n".  fp); 
if  (wire_ptr  !=  NULL) 

Out_Mire_Tree  (w1re_ptr.  fp); 
if  (w_f_rect  !=  NULL) 

{ 

Out_File  ("L  CM;".  "\n".  fp); 

Out_Rect_Tree  (w_f_rect,  fp); 

} 

if  (w_s_rect  !=  NULL) 

{ 

Out_File  ("L  CH2;",  "\n".  fp); 

Qut_Rect  Tree  (w_s  rect,  fp); 

) 

if  (w_d  rect  !=  MULL) 

{ 

Out_File  ("L  CD;",  "\n",  fp); 

Out_Rect  Tree  (w  d  rect,  fp); 

} 

if  (w_p  rect  !=  NULL) 

( 

Out_File  ("L  CP;".  "\n".  fp); 

Out_Rect_Tree  (w_p  rect,  fp); 

} 

if  (w_s  via  !=  NULL) 

{ 

0ut_Fi1e  ("L  CM;".  "\n",fp); 

OutVia  Tree(w_s_via,  M_VIA  SIZE,  fp); 

Out_File  ("L  CM2;".  "\n",fpT; 

Out_Via  Tree(w_s_via,  M2_VIA_SIZE,  fp); 

Out_File  ("L  CC;”,  "\n".fp); 

OutVia  Tree(w_s_via,  C_VIA  SIZE,  fp); 

) 

if  (w_d  via  !=  NULL) 

{ 

Out_FiIe  ("L  CM;".  "\n".fp); 

Out_Via_Tree(w_d_via,  M_VIA  SIZE,  fp); 

Out_F11e  ("L  CD;".  "\n",fp)T 
Out_Via_Tree(w_d_v1a,  D_VIA_SIZE,  fp); 

Out_Fi1e  ("L  CV;".  "\n",fp); 

Out_Via_Tree(w_d_via,  V_VIA_SIZE.  fp); 


if  (w  p_via  !=  NULL) 

{ 

Out_Fne  ("L  CH;".  “\n".fp); 

Out  Via_Tree(w  p  via,  M_VIA_SIZE,  fp); 

OuOne  ("L  CP;".  “\n".fp); 

Out  V1a_Tree(w  p_via.  P_VIA_SIZE.  fp); 

Out  File  ("L  CV;".  "\n“.fp); 

Out  Via_Tree(w  p_via.  V_VIA_SIZE.  fp); 

} 

Out  File  ("(END  HIRE  DEFINITIONS);",  "\n“,  fp); 
printf  ("\n(START  VIA  DEFINITIONS);"); 

Out  File  ("\n(START  VIA  DEFINITIONS);".  "\n“,  fp); 
if  Ts_via  !=  NULL) 

{ 

Out_File  ("(vias  in  Second  to  first  metal  first  m  layer);","\nL  CM;\n",fp); 
Out_Via_Tree(s_via,  M_VIA_SIZE.  fp); 

Out_File  ("(vias  in  second  to  first  metal  second  m  layer);". "\nL  CM2;\n",fp); 
Out_Via_Tree(s_via,  M2_VIA_SIZE.  fp); 

Out  File  ("(vias  in  second  to  first  metal  cut  layer);".“\nL  CC;\n",fp); 
Out~Via_Tree(s  via,  C_VIA_SIZE.  fp); 

} 

if  (d  via  !=  NULL) 

{ 

Out  File  ("(vias  in  Diff  to  first  metal  first  m  layer);","\nL  CH;\n",fp); 
0uOia_Tree(d_via,  M_VIA_SIZE.  fp); 

Out_Fi1e  ("(vias  in  dTff  to  first  metal  diff  layer );" ,"\nL  CD;\n",fp); 

Out_Via  Jree(d_via.  0_VIA_SIZE,  fp); 

Out  File  ("(vias  in  diff  to  first  metal  cut  layer);", "\nL  CV;\n",fp); 
Out"via_Tree(d  via,  V_VIA_SIZE,  fp); 

} 

if  (p_via  !=  NULL) 

( 

Out_File  ("(vias  in  Poly  to  first  metal  first  m  layer);","\nL  CM;\n",fp); 
Out_Vla_Tree(p_via,  M_VIA_SIZE,  fp); 

Out_File  ("(vias  in  poly  to  first  metal  poly  layer);", "\nL  CP;\n",fp); 
Out_Via_Tree(p_via,  P_VIA_SIZE,  fp); 

Out_File  ("(vias  in  poly  to  first  metal  cut  layer);", "\nL  CV;\n".fp); 
Out_Via_Tree(p_via.  V_VIA_SIZE,  fp); 

) 

Out  File  ("(END  VIA  DEFINITIONS);",  "\n".  fp); 
printf  ("\n( START  CALL  STATEMENTS);"); 

0ut_Fi1e  ("\n( START  CALL  STATEMENTS);",  "\n".  fp); 
if  (call_ptr  !=  NULL) 

Out_Can_Tree  (call_ptr,  fp); 

Out_File  ("(END  CALL  STATEMENTS);",  "\n”.  fp); 
printf  ("\n( START  ITER  STATEMENTS);"); 

Out_File  ("\n( START  ITER  STATEMENTS);",  "\n".  fp); 
if  (iter  ptr  !=  NULL)  Out  Iter_Tree  (iter_ptr,  fp); 

0ut_Fi1e~("(END  ITER  STATEMENTS);”,  "\n".  fp); 

) 

Nendif 
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#ifneed  Out_Port_Tree 

^ititifiiiciticicicitiiicicitieificitititit'kifit'kiticicititititititiciciticic^'kit'kic'kic'kirit'k’kicicie'kic'k’k'kit'kic'kit'kic'kitic'k'kit 
it  ★ 

*  Module  Name:  Out_Port_Tree  * 

*  Module  Number:  7.3.1  * 

*  Verslon/Oate:  l.Q  28  July  1985  * 

*  Input  Parameters:  port,  fp  * 

*  Output  Parameters:  none  * 

*  Global s  Used:  none  * 

*  Modules  Called:  Out_File,  Out_Port_Tree  (recursion)  * 

*  Calling  Modules:  0ut_Ce1 l_Layout,  Out_Port_Tree  * 

*  Function:  Place  ports  on  disk  * 

*  PDL:  * 

*  If  the  location  Is  defined  * 

*  If  the  port  hasn't  been  deleted  * 

*  Output  the  CIF  for  the  port;  * 

*  Go  to  the  next  port  location.  * 

*  * 
itititiritieititititititititicititititiricitiriritieic'k'kititititititicitiitit'kititit'kiricicititieitir'kititicitititititititicititieicititicit  j 

Out_Port_Tree  (p_ptr,  fp) 

struct  Inter  ports  *p_ptr; 

FILE  *fp;~ 


char  a_numI7); 

If  (p_ptr  !=  NULL) 

{ 

if  (p_ptr->yJoc  !=  -9999) 

{ 

0ut_F1le  ("94  ",  p_ptr->port_name,  fp); 

putc( ■  ■ ,  fp); 

itoa  (p_ptr->x_1oc,  a_num); 

0ut_F11e  (a_num,  fp); 

Itoa  (p_ptr->y_loc,  a_num); 

Out_File  (a_num,  "  ",  fp); 

If  (p_ptr->port_layer  ==  'F') 

Out_Fne  ("CM;".  "\n".  fp); 
else  If  (p_ptr->port_layer  ==  ’S') 
0ut_F11e  ("CM2;".  "\n".  fp); 
else  If  (p_ptr->port  layer  ==  '0') 
0ut_F11e  ("CD;".  "\n".  fp); 
else  If  (p_ptr->port_layer  ==  'P') 
Out_Fne  ("CP;".  "\n",  fp); 

} 

Out_Port_Tree  (p_ptr->next_port.  fp); 

) 

) 


.  .  J 


y 


'  s’’  • 

.•  o  .y. 


•  -  4  e  I 

.1 


Nendif 
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(tifneed  Out  Rect_Tree 

/*************1*»*************ir****llt************1lt**********************<f** 

*  Module  Name:  Out_Rect_Tree  * 

*  Module  Number:  7.3.2  * 

*  Verslon/Oate:  1.0  28  July  1985  * 

*  Input  Parameters:  rect.  fp  * 

*  Output  Parameters:  none  * 

*  Globa Is  Used:  mln_x_b.  min _y_b,  max_x_b,  max _y_b  * 

*  Modules  Called:  Out_Flle,  Out_Rect_Tree  (recursion)  * 

*  Calling  Modules:  Out_Cel l_Layout.  Out_Rect_Tree  * 

*  Function:  Place  rectangles  on  disk  * 

*  POL:  * 

*  If  the  location  Is  defined  * 

*  Output  the  left  rectangle  structure,  * 

*  If  the  rectangle  hasn't  been  deleted  * 

*  Output  the  CIF  for  the  rectangle;  * 

*  If  needed  adjust  the  cell  bounds;  * 

*  Output  the  middle  rectangle  structure.  * 

*  Output  the  right  rectangle  structure.  * 

★********************<r*********;»r***ltnHt******5it****t****1lt***********Kr*******/ 

Out_Rect_Tree  (rect,  fp) 
struct  rectangle  *rect; 

FILE  "'fp; 

{ 

char  a_num  (7); 

if  (rect  !=  NULL) 


Out_Rect_Tree  (rect->less_than_x,  fp); 
if  ('rect->height  !=  0  I1  rect->length  !=  0) 

( 

Out_File  ("B".  "  ",  fp); 
itoa  (rect->length,  a_num); 

Out_File  (a_num,  "  ",  fp); 
itoa  (rect->height,  a_num); 

Out_File  (a_num,  "  ",  fp); 

itoa  ( (rect->x_location  +  rect->length/2),  a_num); 
Out_File  (a_num,  fp); 

itoa  ((rect->y_location  +  rect->height/2),  a_num); 
Out_File  (a_num,  ";\n",  fp); 
if  (rect->x_location  <  min_x_b) 
min_x_b  =  rect->x_location; 
if  (rect->x_locat1on  +  rect->length  >  max_x_b) 
max_x_b  =  rect->x_location  rect->length; 
if  {rect->y_locat1on  <  rain _y_b) 
min_y_b  =  rect->y_location; 

If  (rect->y_location  +  rect->he1ght  >  max_y_b) 
max_y_b  =  rect->y  location  +  rect->height; 

} 

Out_Rect_Tree  (rect->equals_x.  fp); 

Out  Rect  Tree  (rect->greater_than  x,  fp); 


tfifneed  Out_Mi re_Tree 

^:kicitirieitititiriiifititiitiriiriitititiiifitiritici(iciticicicicititiiiiitifiticicicftificicitiiititii[ititititi(icitititi(i(if’kitltit'kititicic 
•k  * 

*  Module  Name:  0ut_M1re_Tree  * 

*  Module  Number:  7.3.3  * 

*  Verslon/Oate:  1.0  5  August  1985  * 

*  Input  Parameters:  ptr.  fp  * 

*  Output  Parameters:  none  * 

*  Global s  Used:  none  * 

*  Modules  Called:  Out_M  Segment,  0ut_M1re_Tree  (recursion)  * 

*  Out_FiTe  * 

*  Calling  Nodules:  Out_Cell_Layout,  Out_Wlre_Tree  * 

*  Function:  Output  the  wire  statements  to  disk  * 

*  POL:  * 

*  If  there  Is  a  wire  on  this  layer  * 

*  Walk  the  trinary  tree  to  the  left;  * 

*  If  the  wire  has  segments  defined  * 

*  Output  the  starting  location  for  the  wire;  * 

*  Output  the  wire  segments  recursively;  * 

*  Malk  the  tree  to  the  middle;  * 

*  Walk  the  tree  to  the  right;  * 

k  k 
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0ut_H1re_Tree  (ptr,  fp) 

struct  wire  *ptr; 

FILE  *fp; 


char  a_num  (71 ; 

if  (ptr  !=  NULL) 

{ 

Out_Wi re_Tree  (ptr->w_1_t_x.  fp); 
if  ( ptr->w_parain  !=  NULL) 

{ 

itoa  (ptr->w_x_locat1on,  a_num); 

OutFIle  ("(Wire  ",  a_num,  fp); 
itoa  (ptr->w_y_location,  a_num); 

Out_File  (",",  a_num,  fp); 
putc  (■  fp); 

OutWComment  (0,  '  ',  ptr->w_param,  fp); 

Out_FiIe  (");",  "\n".  fp); 

Out_W_Segment  ( ptr->w_x_location,  ptr->w_y_1ocation,ptr->w_param) ; 
} 

Out_Wi re_Tree  (ptr->w_e_x,  fp); 

0ut_W1re  Tree  (ptr->w_g_t_x,  fp); 

) 

) 

Nendif 


#ifneed  Out_W_Coinment 

^****************i»r***1lr********Hr*************'***i»t*****i»r******Hr*****;* 


Hodule  Name:  Out_W_Coniment 

Module  Number:  7.3.3. 1 

Version/Date:  1.0  5  August  1985 

Input  Parameters:  p_v(1dth,  p_layer,  seg,  fp 

Output  Parameters:  none 

Global s  Used:  none 

Modules  Called:  0ut_File,  Out_M_Coninent  (recursion) 
Calling  Modules:  0ut_W1re_Tree,  Out_M_Comment 
Function:  Output  the  segments  of  the  wire  to  disk 
POL: 

If  the  location  Is  defined 
Output  the  comment  describing  this  segment; 
Output  the  next  wire  segment. 
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ititicieiticieiticicitiritititiritiririrititiriririritirirititiritititiititititititititititititicicifiricititicitititititititirititiciticicititit  > 


Out_W_Comment  (p_w1dth.  p_layer,  seg,  fp) 


Int  p_w1dth; 

char  p_layer; 

struct  wire  parameters  *seg; 
FILE  *fpT 


{ 

char  a_w  (71 , 
aj  (71; 

if  (seg  !=  MULL) 

( 

if  (p_layer  !=  seg->w_layer) 

{ 

putc  { seg->w_l ayer ,fp) ; 
putc  ( ■  * .  fp); 

) 

If  (p_width  !=  seg->width) 

{ 

Itoa  (seg->w1dth,  aw); 

Out_File  ("H",  a_w.  fp); 
putc  ( '  ■ ,  fp); 

} 

putc  ( seg->d1rect1on,  fp); 
itoa  ( seg->1ength,  a  1); 

0ut_F11e  a_l,  fp); 
putc  ( '  * ,  fp); 

Out_W_Comment  (seg->w1dth.  seg->w_layer.  seg->next_segment,  fp); 
) 

} 

Nendlf 


01 f need  Out_W_Segment 

*  * 


* 

* 

* 

* 

* 

* 

* 

ic 

* 

it 

it 

it 

* 

* 

* 

it 

it 

it 

* 

* 

* 


Module  Name:  Out_H_Segment 
Module  Number;  7. 3. 3. 2 
Version/Date;  1.0  5  August  1985 

Input  Parameters;  p_x,  p_y,  seg 
Output  Parameters;  none 

Globals  Used:  w_f_rect,  w_s_rect,  w_p_rect,  s_d_rect,  w_s_v1a 
w_p_via,  w_d_vla,  M_VIA_SIZE 
Modules  Called:  0ut_File,  Out_M_Segment  (recursion) 

Cal  1 ing  Modules;  Out_Wlre_Tree.  Out_W_Segment 
Function:  Output  the  segments  of  the  wire  to  disk 
POL: 

If  the  location  Is  defined 
Set  x.y  to  the  bottom  left  of  this  rectangle; 

Place  the  rectangle  In  memory; 

If  there  Is  a  next  segment 
Set  x.y  to  other  end  of  present  segment. 

If  the  next  segment  Is  on  a  different  layer 
Place  a  via  In  memory  at  this  location; 

Set  x.y  location  to  fill  In  corner; 

Go  to  the  next  wire  segment. 
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Out_W_Segment  (p_x,  p_y,  seg) 
struct  wf re_parameters  *seg; 

{ 

int  v_x,  v_y,  x_loc,  y_1oc,  r_he1ght,  r_1ength; 

char  v_layer; 

If  (seg  !=  NULL) 

( 

switch  (seg->d1 recti  on) 

{ 

case  'f  :  x_loc  =  p_x;  y_loc  =  p_y  -  seg->w1dth/2; 

r_height  =  seg->w1dth;  r_length  =  seg->1ength;  break; 
case  'b'  :  x_loc  -  p_x  -  seg->length;  y_loc  =  p_y  -  seg->width/2; 

r_height  =  seg->w1dth;  r_1ength  =  seg->1ength;  break; 
case  'u'  ;  x_loc  p_x  -  seg->w1dth/2;  y_1oc  =  p_y; 

r_height  =  seg->1ength;  rlength  =  seg->w1dth;  break; 
x_1oc  =  p_x  -  seg->w1dth/2;  y_loc  =  p_y  -  seg->1ength; 
r_height  =  seg->length;  r_length  =  seg->w1dth;  break; 


case  'd' 


switch  (seg->w_layer) 

{ 

case  'F'  :  Rect_Tree  (r_height,r_1ength,x_loc,y_loc,&w_f_rect) ; 

break; 

case  ‘S'  :  Rect_Tree  (r_height,r_1ength,x_loc,y_1oc,&w_s_rect ) ; 

break; 

case  'D'  :  Rect_Tree  (r_height,r_1ength,x_loc,y_loc,&w_d_rect); 

break ; 

case  'P'  :  Rect_Tree  (r_height,r_length,x_loc,y_loc,&w_p_rect); 

break; 

} 


if  (seg->next_segment  !=  NULL) 

{ 

switch  (seg->direction) 

{ 

case  'f  :  p_x  =  p_x  +  seg->length;  break; 

case  'b‘  p_x  =  p_x  -  seg->length;  break; 

case  'u'  :  p_y  =  p_y  +  seg->iength;  break; 

case  'd'  :  p_y  =  p_y  -  seg->length;  break; 

} 

if  (seg->w  layer  !=  seg->next_segment->w_l ayer ) 

v_x  *  p_x  -  M  VIA  SIZE/2; 
v_y  =  P_y  -  M_VIA_SIZE/2; 
if  (seg->w_layer  ==  'F') 
v_layer  =  seg->next_seginent->w_layer; 
eTse  v_layer  =  seg->w_layer; 
switch  (v  layer) 
i 

case  'S'  ;  Via_Tree  (v_x,  v_y,  &w_s_via);  break; 

case  'O'  :  Via_Tree  (v_x,  v_y,  &w_d_via);  break; 

case  'P'  :  Via  Tree  (v  x,  v  y,  &w_p_via);  break; 


swi tch  ( seg->next_segment->di rection ) 

{ 

case  'f*  : 

if  {seg->d1rection  ==  'u‘  II  seg->di recti  on  ==  *d') 

P_x  =  P_x  ~  seg->w1dth/2; 

seg->next_seginent->  length  =  seg->next_segment->1ength  +  seg->vKidth/2; 

break; 
case  ‘b*  ; 

if  (seg->direction  ==  'u'  1 1  seg->direction  ==  'd') 

{ 

p_x  =  p_x  +  seg->width/2; 

seg->next_seginent->1ength  =  seg->next_segment->length  +  seg->width/2; 
} 

break; 
case  'u'  ; 

if  |seg->direction  ==  ‘f  It  seg->d1 recti  on  ==  ’b*) 

{ 

P_y  =  P_y  “  seg->width/2; 

seg->next_segment-> length  =  seg->next_segment->1ength  +  seg->width/2; 
} 

break; 
case  'd'  : 

if  (seg->d1 rection  *=  ‘f*  ||  seg->di recti  on  ==  'b') 

{ 

P_y  =  P_y  seg*>width/2; 

seg->next_segment->1ength  =  seg->next  segment->length  +  seg->width/2; 
) 

break; 

} 

} 

Out_M_Seginent  (p_x,  p_y,  seg->next_segment); 

} 

f 

#endif 


ffifneed  Out_\/ia_Tree 

^it'kicici(it'kit'ki('kiei('kiciticif-kit'kicicitieifitititir*icftif1tic'k'kit'0['0ci[icit'kici[if^iiei(ir*itici(*icicieific'kieic'k'kicikiei^if 


★ 

* 

* 

* 

* 

it 

* 

* 

★ 

it 

it 

* 

* 

Hr 

Hr 

* 

Hr 


Module  Name;  Out_Vta_Tree 
Module  Number;  7.3.4 
Version/Date;  1.0  5  August  1985 

Input  Parameters;  l_v1a.  v1a_s1ze,  fp 
Output  Parameters;  none 

Globa Is  Used;  min_x_b,  min _y_b,  max_x_b.  max _y_b 
Modules  Called;  0ut_F11e,  Out_yia_Tree  (recursion) 

Calling  Modules:  Out_Cell_Layout,  Out_Via_Tree 

Function;  Output  the  vlas  to  disk  one  rectangle  at  a  time 

POL: 

If  this  location  is  defined 
Output  the  left  via  tree; 

If  this  via  hasn't  been  deleted 
Output  the  box  for  the  via. 

If  needed  adjust  the  cell  bounds; 

Output  the  middle  via  tree; 

Output  the  right  via  tree. 
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Out_\/ia_Tree  (1_via,  via_size,  fp) 
int  via_size; 

struct  via  *1_via; 

FILE  *fp; 

{ 


char  a_num  [71; 
if  (l_via  !*  NULL) 
{ 


Out_Via_Tree  (1_via->v_1  t  x,  via_size,  fp); 
if  (1  via->v_y  location  T="-9999) 

{ 


Out_File  ("B".  "  ",  fp); 
itoa  (via_size,  anum); 

Out_File  U_num,  "  ",  fp); 

0ut_Fi1e  (a_num,  "  ",  fp); 

itoa  ( l_via->v_x_location  +  M_VIA_SIZF./2,  a_num); 
0ut_Fi1e  (a_num,  fp); 

itoa  ( l_via->v_y_1ocation  +  M_VIA_SIZE/2,  a_num); 
Out_File  (a_num,  ";\n",  fp); 
if  { l_v1a->v_x_location  <  min_x_b) 
m1n_x_b  =  1_via->v_x_location; 
if  ( l_via->v_x_location  +  via_size  >  maxxb) 
max_x_b  =  1_via->v_x_1ocation  via  size; 
if  ( 1_via->v_y_location  <  min_y_b) 
m1n_y_b  =  l_via->v_y_location; 
if  ( 1_via->v_y_1ocation  +  via_size  >  max_y_b) 
max_y_b  =  1_via->v_y_location  +  via_size; 

) 


Out_Via_Tree  ( 1_via->v_e_x.  via_size,  fp); 
0ut_V1a_Tree  ( 1_via->v_g_t  x,  v1a_size.  fp); 
)) 

Nendif 


276 


#1fneed  Out_Ca1 l_Tree 
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Module  Name:  Out_Can_Tree 
Module  Number:  7.3.5 
Version/Oate:  1.0  21  August  1985 

Input  Parameters:  ptr,  fp 
Output  Parameters:  none 
Global s  Used:  none 

Modules  Called:  0ut_F11e.  Out_Cal l_Tree  (recursion), 
Out_C_Statements.  Out_P_Names 
Calling  Modules:  Out_Cel 1_Layout,  Out_Cal 1_Tree 
Function:  Output  the  Call  statements  to  disk 
POL: 

If  this  location  Is  defined 
Output  the  left  call  tree; 

If  this  call  hasn't  been  deleted 
Output  the  comment  describing  this  call. 

Output  the  CIF  call  statement. 

Output  the  portnames; 

Output  the  middle  call  tree; 

Output  the  right  call  tree. 
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Out_Cal 1_Tree  (ptr,  fp) 
struct  cal 1_statement  *ptr; 

FILE  *fp; 

{ 

char  a_num  (7); 


if  (ptr  !=  NULL) 

{ 

Out_Ca I l_Tree  (ptr->l_t_name,  fp); 
if  (ptr->tran_y  !=  -9999) 

( 

0ut_F11e  ("(Call  ",  ptr->cel Iname,  fp); 
itoa  (ptr->tran_x,  a_num);  0ut_F11e  ("  ",  a_num,  fp); 
itoa  (ptr->tran_y ,  a_num);  0ut_F11e  (",",  a_num,  fp); 
itoa  (ptr->x_m1n,  a_num);  0ut_F11e  ("  bounds  ",  a_num,  fp); 

itoa  (ptr->y_min,  a_num);  Out_File  (",",  a_num,  fp); 

itoa  (ptr->x_max,  a_num);  Out_Flle  ("  ",  a_num,  fp); 

itoa  (ptr->y_max,  a_num);  Out_File  (”,",  a_num,  fp); 

Out_File  (");",  "\n",  fp); 

Out_C_Statement  ( ptr->c i fnum,  ptr->tran_x , ptr->tran_y , ptr->mi r_x , 

ptr->m1 r _y . ptr->rot_x , ptr->x_m1 n , ptr->y_m1  n , ptr->x_max , ptr->y_max , f p ) ; 
Out_P_Names  (ptr->c_ports,fp); 

} 

Out_Cal l_Tree  (ptr->e_name,  fp); 

Out_Can_Tree  (ptr->g_t_name,  fp); 

} 

} 

Nendif 
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#1fneed  Out_C_Statement 

y ************************************************************************ 

*  * 

*  Module  Marne:  Out_C_Statement  * 

*  Module  Number:  7.3.5. 1  * 

*  Version/Date:  1.0  21  August  1985  * 

*  Input  Parameters:  ptr,  fp  * 

*  Output  Parameters:  none  * 

*  Globa Is  Used:  m1n_x_b,  min _y_b,  max_x_b,  max _y_b  * 

*  Modules  Called:  Out_File  * 

*  Calling  Modules:  Out_Can_Tree,  Out_Iter_Tree  * 

*  Function:  Output  the  Call  statements  to  disk  * 

*  POL:  * 

*  Output  the  CIF  call  statement.  * 

*  If  needed  adjust  the  bounds.  * 

*  ★ 

Out_C_Statement  (cifnum.  tran_x.  tran _y.  m1r_x.  mir _y.  rot_x.  x_m1n,  y_m1n 
X  max.  y_max,  fp) 

FILE  *fp; 

1 

char  a_num  [71 ; 

Int  temp; 

Itoa  (cifnum.  a  num);  Out  File  (“C  ",  a_num,  fp); 
if  (mir_x  ==  TRUE) 

Out  File  ("  M".  "  X",  fp); 
if  (mir _y  ==  TRUE) 

Out  File  ('•  M",  Y",  fp); 

if  (rot  x  !=  ■  •) 

{ 

if  (rot_x  ==  'B')  Out  File  ("  R  ",  "1,0".  fp); 


-W 


“.V  *A 


else  if  (rot_x  ==  '6')  0ut_File  ("  R 

else  if  (rot_x  ==  '9')  Out_File  ("  R 

else  if  (rot_x  ==  T)  0ut_Fi1e  ("  R 

) 

if  (mir_x  ==  TRUE) 

{ 

temp  =  y_min; 
y_min  =  -y_max; 

y_max  =  -temp; 

} 

if  (mir_y  ==  TRUE) 

{ 

temp  =  x_min; 
x_min  =  -x_max; 

X  max  =  -temo: 


"O.-l".  fp) 
"-1.0",  fp) 
"0.1".  fp); 


if  (rot  X  ==  ’e') 

( 

temp  =  x_min; 
x_mln  =  y_min; 
y_min  =  -x_max; 
x_fflax  «  y_max; 
y_max  =  -  temp; 

} 

else  if  (rot_x  '9' ) 
{ 

temp  =  x_min; 
x_m1n  =  -x_max; 
x_max  =  -x_m1n; 
temp  =  y_m1n; 
y_min  =  -y_max; 
y_max  =  -y_min; 

} 

else  If  (rot_x  *=  *  1' ) 
{ 

temp  =  x_min; 
x_mln  =  -y_max; 
y_max  =  x_max; 
x_max  =  "y_min; 
y  min  =  temp; 

r 


itoa  ((tran_x  -  x_min),  a_num);  Out_Flle  ("  T  ",  a_num,  fp); 

itoa  ((tran _y  -  y_min),  a_num);  Out_File  a  num,  fp); 

Out_File  "\n".  fp); 

if  Ttran_x  <  min_x_b)  min_x_b  =  tran_x; 

if  ((tran_x  +  x_max  -  x_mTn)  >  max_x_b)  max_x_b  *  tran_x  +  x_max  -  x_ 
if  (tran _y  <  min_y_b)  min_y_b  =  tran^y; 

if  (tran _y  +  y_max  -  y_min  >  max _y_b)  max _y  b  =  tran _y  +  y_max  -y_min 
) 


iVendif 


#1fneed  Out_P_Mames 

it  * 

Module  Name:  Out_P_Names  * 

Module  Number:  7. 3. 5. 2  * 

Version/Date:  1.0  21  August  1985  * 

Input  Parameters:  ptr,  fp  * 

Output  Parameters:  none  * 

Globa Is  Used:  none  * 

Modules  Called:  Out_Flle  * 

Calling  Modules:  Out_Call_Tree.  Out_Iter_Tree  * 

Function:  Output  the  Call  statements  to  disk  * 

POL:  * 

While  there  are  portnames  associated  with  this  call  * 

Output  the  portnames;  * 

* 

irit1eitiriritiriritlritirir*ititir1rititiritiririrititlricifiticitititicit'kititititicicicititititititicicititit1titititii1titititirif1(ititit  j 

Out_P_Names  (ptr,  fp) 

struct  named_ports  *ptr; 

FILE  *fp: 


while  (ptr  !=  NULL) 

{ 

If  (ptr->port  name(0]  !=  ’-') 

{ 

Out  File  ("(Port  ",  ptr->port_name,  fp); 
OuOile  (");",  "\n",  fp); 

) 

ptr  =  ptr->next_name; 

} 
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#ifneed  Out_lter_Tree 
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Module  Marne:  Out_Iter_Tree 

Module  Number:  7.3.6 

Version/Oate:  1.0  17  September  1985 

Input  Parameters:  ptr,  fp 

Output  Parameters:  none 

Globa  Is  Used:  none 

Modules  Called:  Out_File.  Out_Iter_Tree  (recursion), 
Out_C_Statement,  Out_P_Names 
Cal  1 ing  Modules:  Out_Cel l_Layout,  Out_Iter_Tree 
Function:  Output  the  Iter  statements  to  disk 
POL: 

If  this  location  Is  defined 
Output  the  left  call  tree; 

If  this  call  hasn't  been  deleted 
Output  the  comment  describing  this  call. 

Output  the  CIF  call  statement. 

If  needed  adjust  the  bounds. 

While  there  are  portnames  associated  with  this  call 
Output  the  portnames; 

Output  the  middle  call  tree; 

Output  the  right  call  tree. 
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Out_Iter_Tree  (ptr,  fp) 


struct  Iter  statement  *ptr: 
FILE  *fpT 


{ 

char 
i  nt 


a_num  [7] ; 

1 .  j .  t_x .  t_y ; 


if  (ptr  !=  NULL) 

{ 

Out_Iter_Tree  (ptr->l_t_c1fnum,  fp); 
if  (ptr->x_iters  !=  -9999) 

{ 

OutFile  ("(Iter  ",  ptr->cel Iname,  fp); 
putc  ( '  ■ ,  fp); 
itoa  (ptr->x_iters,  anum); 
itoa  (ptr->y_iters,  a_num); 
itoa  (ptr->x_pitch,  a_num); 
itoa  (ptr->y_p1tch,  a_num); 


Out_File  (a_num, 
Out_F11e  (a_num, 
Out_F11e  (a_num, 
Out_F11e  (a_num. 


fp); 

fp); 

fp); 

fp); 


itoa  (ptr->1  call->tran  x,  a  num);  Out  File  (a  num,  fp); 


itoa  (ptr->i_cal1->tran _y,  a_num); 
ftoa  (ptr->i_caH->x_fflin,  a_nuffl): 
Itoa  (ptr->1_cal1->y_rain,  a_nuin); 
itoa  (ptr->i~cal l->x_max,  a_num); 
itoa  (ptr->i  ca11->y_roax,  a_nuffl); 
Out  File  (")T“.  “\n".  fp); 
i  =  0; 

while  (i  <  ptr->x_iters) 

{ 

J  X  0; 

while  (j  <  ptr->y_iters) 


0ut_File 
0ut_File  ( 
Out  File  ( 
Out_File  ( 
Out_File  ( 


(a_num.  "  " 
"  bounds  ", 
a_num, 
"  ",  a_num, 
a_nuffl. 


fp); 

a_num,  fp) 
fp): 
fp); 
fp): 


t_x  =  ptr->i_call->tran_x  +  1  *  ptr->x_p1tch; 
t_y  =  ptr->i_call->tran_y  +  j  *  ptr->y_pitch; 

Out_C_Statenient  (ptr->cifnum,  t_x,t _y.ptr->i_call->m1r_x, 
ptr->i_cal l->fflir_y,ptr->i_call->rot_x,ptr->i_cal 1->x_min, 
ptr->i~cal l->y_min,ptr->i_call->x_max,ptr->i_cal l->y_max,fp); 

++J; 

) 


++i; 

) 

Out_P_Names  (ptr->i_call->c  ports, fp); 
) 

Out_Iter_Tree  (ptr->e_c1fnum,  fp); 

Out  Iter_Tree  (ptr->g_t  cifnum,  fp); 

} 


/tend  If 


#1fneed  Footer_0ut_F11e 

^***tt1ltinr*********************f****#*****»*t******>lr**********************«** 
*  * 

*  Module  Name:  Footer_Out_Fne  * 

*  Module  Number:  7.4  * 

*  Version/Date:  1.0  28  July  1985  * 

*  Input  Parameters:  cell  name,  a_cifnum,  fp  * 

*  Output  Parameters:  none  * 

*  Globa Is  Used:  m1n_x_b,  min _y_b,  max_x_b,  max_y_b  * 

*  Modules  Called:  Out_File  * 

*  Calling  Modules:  SAVECELL  Main  * 

*  Funtlon;  Output  the  CIF  file  footer  * 

*  POL:  M/A  * 

*  * 


Footer_0ut_F1 le  (cellname.  a_c1fnum,  fp) 
char  *cellname. 

*a_c1fnum; 

FILE  *fp; 

{ 

char  a_nuffl  [7]; 

printf  ("attaching  file  footer  for  cell  »s\n“,  cellname); 
0ut_F11e  ("(bounds".  "  fp); 

0ut_F11e  (cellname,  "  ",  fp); 
itoa  (mln_x_b,  a_num); 

0ut_F11e  (a_num,  fp); 
itoa  (ro1n_y_b.  a_num); 

0ut_F11e  (a_nuro,  "  ",  fp); 

Itoa  (max_x_b,  a_num); 

0ut_F11e  U_num,  ",",  fp); 

Itoa  (max_y_b,  a_num); 

0ut_F11e  (a_num,  ");\nDF;\nC  ",fp); 

0ut_File  (a_c1fnum,  "  ",  fp); 
itoa  (-m1n_x_b,  a_num); 

0ut_F11e  ("T  ",  a_nuffl,  fp); 

Itoa  (-min_y_b,  a_num); 

0ut_File  (“,",  a  num,  fp); 

0ut_Fi1e  (";\n",  "E\n",fp); 

} 


Nendlf 


Appendix  C 
Sample  HOCLL  Output 

Included  In  this  appendix  are  the  GIF  files  for  six  cells  created 
using  the  HDCLL  system.  Each  cell  Is  foil  owed  by  a  plot  of  the  circuit 
described  using  the  program  HCIFPLOT.  The  cells  Included  are  MASK  (used 
to  mask  bits  In  a  content  addressable  memory.  CAH),  HEH  (a  six  transistor 
memory  cell),  SUB  (a  full  subtractor  for  use  In  a  CAH).  BINBOUT  (a 
combination  of  MASK.  HEH,  SUB,  and  needed  Interconnections),  HEH2  (two 
calls  to  the  BINBOUT  cell),  and  HEH8  (an  Iteration  of  eight  BINBOUT 
cells).  The  finalized  GIF  file  version  (as  provided  by  the  FINALIZE 
program)  of  the  BINBOUT,  HEH2,  and  HEH8  cells  Is  not  provided  since  each 
Is  simply  a  combination  of  the  called  cells  GIF  descriptions.  However, 
the  finalized  version  was  used  to  produce  the  plots  for  each  of  these 


v^,>v;*.v  \\i  \\ \\  ■>  L% "A^^  'A ’AW  K*^r  K^  KnK\ V^4J*v^'J^\w'^w 


t;  V  :v  I  •■ 


I  ^ 
i 


L  CD; 

B  60  14  30.55; 
B  60  8  30,16; 

B  4  0  4,16; 

B  4  2  4,51; 

B  0  4  34.16; 

B  0  4  34,52; 

B  4  2  56.51; 

B  0  4  56.16; 

L  CP; 

B  A  22  12,55; 

B  10  4  15,44; 

B  4  16  12.16; 

B  10  4  15,24; 

B  4  4  20,44; 

B  4  4  20.24; 

B  4  2  20,27; 

B  14  4  25.28; 

B  4  18  32.35; 

B  18  4  39.44; 

B  6  4  45.30; 

B  4  24  48.20; 

B  4  24  48.54; 

L  CH; 

B  8  8  20,52; 

B  8  8  20.16; 

B  8  8  40,16; 

B  8  8  40,52; 

L  CS; 

B  8  8  20,52; 

B  8  8  20,16; 

B  8  8  40.16; 

B  8  8  40,52; 

L  CC' 

B  4  4  20,52; 

B  4  4  20,16; 

B  4  4  40,16; 

B  4  4  40,52; 

L  CM; 

B  8  8  4,16; 

B  8  8  4,52; 

B  8  8  34,16; 

B  8  8  34.52; 

B  8  8  56,16; 

B  8  8  56,52; 


mi 
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L  CD; 
B  8  8 
B  8  8 
B  8  8 
B  8  8 
B  8  8 
B  8  8 
L  CG; 
B  4  4 
B  4  4 
B  4  4 
B  4  4 
B  4  4 
B  4  4 
L  CM; 
B  8  8 
B  8  8 
B  8  8 
B  8  8 
L  CP; 
B  10 
B  10 
B  10 
B  10 
L  CG; 
B  4  4 
B  4  4 
B  4  4 
B  4  4 
(END 


4,16; 

4.52; 

34.16; 

34.52; 

56.16; 

56.52; 

4.16; 

4.52; 

34.16; 

34.52; 

56.16; 

56.52; 

20.42; 

20.26; 

20.26; 

42.30; 

10  20.42; 

10  20.26; 

10  20.26; 

10  42.30; 

20.42; 

20.26; 

20.26; 

42.30; 

MIRE  DEFINITIONS); 


(START  VIA  DEFINITIONS) 
(END  VIA  DEFINITIONS); 

(START  CALL  STATEMENTS) 
(END  CALL  STATEMENTS); 

(START  ITER  STATEMENTS) 
(END  ITER  STATEMENTS); 
(bounds  MASK  0,0  60,66) 
OF; 

C  32077  T  0,0; 

E 


Window:  -^.^00  0  0  7150 

Scale:  1  micron  is  .1118881  inches 


I ■  '  I  KM  K  1 

I*  -1  k\1  kXN 

— 1 — nn 
h  ♦  1  1 

1.  .  I  ! 

1*.  • •  L"!  • •  L'.  -  L  •  'li  •  l%  •  •  /•  •  /.  •  T.  • 

[:*•'* :  :  *'•"*■* :  *>  :*•) :  •)  v :  ••  *  ••  -  v 

V't  vl 

■.•.tk-.’i-.f.-.l 

b’lTfriirwjhvTNrjrvwcs^ 

'.'JlA-Ci-J-JJ 

n  .-j 

'..-■j*  1  1 

•:i.:-k  1  1 
•■:>yX  1  1 
:t;L  1  1 
1  1 

•;r.r  (  1 
■-.r-.r  1  1 
1  1 
1  1 
1  1 

■:t;:k.  1  1 
k-l.LI  1 
1  1 

I'X'T  !  1 

t--r-:r  1  1 
y.-ir.-V’  1  1 

i#;-#;i  1  ‘~«i  N  x  '‘4  xj 

I-:*:-.  !  rx  'x  H.fxS.:C.:rxfi  fx  XN  X.fS.  X.K  xr-Jx  1 

l':  ';l  1  fi!!!;i”;!:!!.:hJ  “  *  ‘  k^"!  “ 

['■■■■'■■i  kXI 

IfAf-l  k\'H 

l#;*:(  t\N  Miawib\.'>iU->  . 

l-x'l  kf>i^l2a2a;m\'\^^  kLiiasikUM 

ia;x:i  LrH.;5<sr;-!;M.\\KKi 

l':  ':|  f\  \  ■••1  ri'A/^IpiifkiN  i-P==i===W. '-'si 

fr^4H;:157!71-:<;W  \*  *1  KVI 

|f  ;'  |  1*  *1  k\-< 

CX'tMW'H 

kutau-j 

OS  4139  50  1; 

(TITLE  MEM  4139); 

(START  PORT  DEFINITIONS); 

(END  PORT  DEFINITIONS); 

(START  RECTANGLE  DEFINITIONS); 

(END  RECTANGLE  DEFINITIONS); 

(START  WIRE  DEFINITIONS); 

(Wire  0,12  D  W16  f24  ); 

(Wire  0,60  F  W4  f78  ); 

(Wire  4,8  D  W4  uO  F  u8  S  uO  -); 

(Wire  6,0  S  W4  u62  ); 

(Wire  6,58  F  W4  fO  P  f2  dlO  f4  d48  ); 
(Wire  16,51  D  W14  f46  ); 

(Wire  20,8  0  W4  uO  F  b2  u40  f2  0  uO  ); 
(Wire  20,20  F  W4  f24  u2  P  fO  ); 

(Wire  24,8  0  W8  f30  ); 

(Wire  26,0  S  W8  u62  ); 

(Wire  28,0  P  W4  u62  ); 

(Wire  36,48  D  W4  uO  F  f6  S  W8  f6  ); 
(Wire  42,8  0  W4  uO  F  b6  S  W8  b6  ); 
(Wire  50,0  P  W4  u62  ); 

(Wire  52,0  S  W8  u62  ); 

(Wire  54,36  F  W4  b24  d2  P  bO  ); 

(Wire  58,8  0  W4  uO  F  b2  u40  f2  0  uO  ); 
(Wire  72.0  S  W4  u62  ); 

(Wire  72,58  F  W4  fO  P  b2  dlO  b4  d48  ); 
(Wire  74.8  0  W4  uO  F  u8  S  uO  ); 

(Wire  78,12  0  W16  b24  ); 

L  CM; 

B  78  4  39.60; 

B  4  8  4.12; 

B  0  4  6,58; 

B  4  42  18,27; 

B  4  4  18,48; 

B  4  4  20,8; 

B  24  4  32,20; 

B  4  4  30,36; 

B  24  4  42,36; 

B  8  4  38,48; 

B  8  4  40,8; 

B  4  4  44,20; 

B  4  42  56,27; 

B  4  4  56.48; 

B  4  4  58,8; 

B  0  4  72,58; 

B  4  8  74,12; 

L  CS; 

B  4  0  4,16; 

B  4  62  6,31; 


B  8  62  26.31; 
B  6  8  33.8; 

B  6  8  45.48; 

B  8  62  52.31; 
B  4  62  72.31; 
B  4  0  74.16; 

L  CD; 

B  24  16  12.12 
B  4  0  4.8; 

B  46  14  39.51 


B 

4 

0 

20.8; 

B 

4 

2 

20.47; 

B 

30  8 

39.8; 

B 

4 

0 

36.48; 

B 

4 

0 

42.8; 

B 

24  16  66.12 

B 

4 

0 

58.8; 

B 

4 

2 

58.47; 

B 

4 

0 

74.8; 

L 

CP; 

B 

2 

4 

7.58; 

B 

4 

12 

8.54; 

B 

6 

4 

9.48; 

B 

4 

50 

12.25; 

B 

4 

62 

28.31; 

B 

2 

4 

31.34; 

B 

2 

4 

43.22; 

B 

4 

62 

50.31; 

B 

4 

50 

66.25; 

B 

6 

4 

69.48; 

B 

4 

12 

70.54; 

B 

2 

4 

71.58; 

L 

CM; 

B 

8 

8 

4.16; 

B 

8 

8 

36.8; 

B 

8 

8 

42.48; 

B 

8 

8 

74.16; 

L 

CS; 

B 

8 

8 

4.16; 

B 

8 

8 

36.8; 

B 

8 

8 

42.48; 

B 

8 

8 

74.16; 

L 

CC; 

B 

4 

4 

4.16; 

B 

4 

4 

36.8; 

B 

4 

4 

42.48; 

B 

4 

4 

74,16; 

L 

CM; 

B 

8 

8 

4.8; 

B 

8 

8 

20.8; 

B 

8 

8 

20.48; 

B 

8 

8 

36,48; 

Scale:  1  micron  is  .1118661  inches 
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DS  4888  50  1; 

(TITLE  SUB  4888); 

(START  PORT  DEFINITIOMS) ; 

(END  PORT  DEFINITIONS); 

(START  RECTANGLE  DEFINITIONS); 
(END  RECTANGLE  DEFINITIONS); 

(START  MIRE  DEFINITIONS); 


(Wire 

0.10  0  W8  f44  u6  f8 

uO  f42  ) 

t 

(Wire 

0,53  0  M14  f94  ); 

(Wire 

4.50  0  W4  uO  F  d2  fl2  dlO  f6 

d2  P  u6 

;  fl4 

u22  ); 

(Wire 

4,10  D  M4  uO  F  u2  fl2  u8 

f6 

u2  P  d4 

fl4  dl6 

): 

(Wire 

10,24  P  M8  b6  F  ulO 

S  M4 

u2 

f40  ); 

(Wire 

12,2  P  M4  u62  ); 

(Mire 

28,8  D  W4  uO  F  u2  f6 

u38 

b6 

u2  D  uO 

); 

(Wire 

37,29  F  M4  fO  P  d2  f8  d2 

fl4 

); 

(Wire 

45,2  S  W4  u62  ); 

(Mire 

47,15  S  M4  bO  F  f6  D 

bO 

); 

(Wire 

47,50  S  M4  bO  F  f6  0 

fO 

): 

(Mire 

61.8  P  W4  ul8  f6  u8 

no 

u30 

): 

(Mire 

69,10  D  M4  uO  F  u6  S 

u26 

MO 

fO  F  bO 

M4  u8 

1  D 

uO  ); 

(Wire 

77,8  P  M4  ul8  fl2  ); 

(Mire 

79,42  P  M4  f32  ); 

(Mire 

85,16  D  M4  bO  F  f6  S 

u34 

F  b6  0  uO  ) 

» 

(Wire 

101.18  0  M8  fl6  ); 

(Mire 

101,53  0  M14  f24  ); 

(Wire 

101,29  F  M4  bl2  u2  P 

uO 

F  d2 

b32  u6 

P  f2 

u6 

f2  u22  ); 

(Wire 

105,18  D  M4  fO  F  b2 

u32 

f2  0 

uO  )  ; 

(Mire 

113,10  P  M4  u54  ); 

(Wire 

113,2  S  M8  u62  ); 

(Wire 

115,41  P  MIO  dlO  ); 

(Wire 

121,50  0  W4  uO  F  W8 

dl4 

b6  S 

uO  ); 

(Mire 

121,18  D  M8  uO  F  f8 

S  uO 

); 

(Mire 

131,2  S  M8  u62  ); 

L  CM; 

B  8  14  4,27; 

B  4  2  4,49; 

B  14  4  9,48; 

B  4  2  4,11; 

B  14  4  9,12; 

B  4  12  16,44; 
B  8  4  18,38; 

B  4  10  16,15; 
B  8  4  18,20; 

B  4  4  22,38; 

B  4  4  22,20; 

B  4  2  28,9; 
884  30,10; 

B  4  4  28,48; 
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B  8  4  32.48; 

B  4  40  34,28; 
B  0  4  37,29; 

B  6  4  50,15; 

B  6  4  50,50; 

B  4  8  57.31; 

B  34  4  74,29; 
B  4  6  69,13; 

B  4  8  69.46; 

B  6  4  88.16; 

B  8  4  89,50; 

B  4  4  89,29; 

B  4  2  89.30; 

B  12  4  95.29; 
B  4  34  103,33 
B  4  4  103.50; 
B  2  4  104,18; 
B  10  8  120.36 
B  8  14  121,43 
B  12  8  123,18 
L  CS; 

B  4  2  4,35; 

B  42  4  23.36; 
B  4  62  45.33; 
B  0  4  47,15; 

B  0  4  47,50; 

B  4  26  69,29; 
B  2  0  68,42; 

B  4  36  91,32; 
B  8  62  113,33 
B  8  4  115,34; 
B  8  4  129,16; 
B  8  62  131,33 
L  CO; 

B  44  8  22,10; 
B  94  14  47,53 
B  4  0  4,50; 

B  4  0  4,10; 

B  4  0  28,8; 

B  4  0  28,50; 

B  8  10  44.11; 
B  12  8  46.16; 
B  8  4  52,14; 

B  46  8  71.16; 
B  0  4  53,15; 

B  0  4  53,50; 

B  4  0  69,10; 

B  4  0  69,50; 

B  4  2  85.49; 

B  0  4  85,16; 

B  16  8  109,18 


B  24  14  113,53 
B  4  2  105,49; 

B  0  4  105,18; 

B  8  0  121,18; 

B  4  0  121,50; 

L  CP; 

B  6  8  7,24; 

B  4  62  12,33; 

B  4  6  22,39; 

B  16  4  28,42; 

B  4  4  22,20; 

B  16  4  28,18; 

B  4  24  36,52; 

B  4  18  36,11; 

B  4  4  37,29; 

B  10  4  40,27; 

B  4  4  45,27; 

B  16  4  51,25; 

B  4  4  57,35; 

B  4  8  59,37; 

B  4  4  59,41; 

B  4  18  61,17; 

B  8  4  63,26; 

B  4  24  61,51; 

B  4  10  67,29; 

B  12  4  71,34; 

8  4  32  77,48; 

B  4  18  77,17; 

B  14  4  82,26; 

B  32  4  95,42; 

B  4  0  89,31; 

B  10  10  115,36 
B  4  54  113,37; 
L  CM; 

B  8  8  4,34; 

B  8  8  47,15; 

B  8  8  47,50; 

B  8  8  69,16; 

B  8  8  69,42; 

B  8  8  91,16; 

B  8  8  91.50; 

B  8  8  115,36; 

B  8  8  129,18; 

L  CS; 

B  8  8  4.34; 

B  8  8  47.15; 

B  8  8  47.50; 

B  8  8  69.16; 

B  8  8  69.42; 

B  8  8  91.16; 

B  8  8  91.50; 


\m 

mi 


B  j 

3  8 

115,36; 

B  1 

3  8 

129,18; 

L  1 

CC; 

B 

4  4 

4,34; 

B 

4  4 

47,15; 

B 

4  4 

47,50; 

B 

4  4 

69,16; 

B 

4  4 

69,42; 

B 

4  4 

91,16; 

B 

4  4 

91,50; 

B 

4  4 

115,36; 

B 

4  4 

129,18; 

L 

CM; 

B 

8  8 

4,50; 

B 

8  8 

4,10; 

B 

8  8 

28,8; 

B 

8  8 

28,50; 

B 

8  8 

53.15; 

B 

8  8 

53.50; 

B 

8  8 

69.10; 

B 

8  8 

69,50; 

B 

8  8 

85,16; 

B 

8  8 

85,50; 

B 

8  8 

105,18; 

B 

8  8 

105,50; 

B 

8  8 

121,50; 

B 

8  8 

121,18; 

L 

CO; 

B 

8  8 

4.50; 

B 

8  8 

4.10; 

B 

8  8 

28.8; 

B 

8  8 

28,50; 

B 

8  8 

53.15; 

B 

8  8 

53,50; 

8 

8  8 

69.10; 

B 

8  8 

69.50; 

B 

8  8 

85.16; 

B 

8  8 

85,50; 

B 

8  8 

105,18 

B 

8  8 

105,50 

B 

8  8 

121,50 

B 

8  8 

121,18 

L 

CG; 

B 

4  4 

4.50; 

B 

4  4 

4.10; 

B 

4  4 

28.8; 

B 

1  4  4 

28,50; 

B 

4  4 

53,15; 

B 

;  4  4 

53,50; 

B 

>  4  4 

i  69,10; 

e 

1  4  4 

i  69,50; 

VAHi 


B  4  4  85.15; 

B  4  4  85.50; 

B  4  4  105.18; 

B  4  4  105.50; 

B  4  4  121.50; 

B  4  4  121.18; 

L  CM; 

B  8  8  4.24; 

B  8  8  22.36; 

B  8  8  22.22; 

B  8  8  37.29; 

B  8  8  57.35; 

B  8  8  89.31; 

B  8  8  89.31; 

L  CP; 

B  10  10  4.24; 

B  10  10  22.36; 

B  10  10  22.22; 

B  10  10  37.29; 

B  10  10  57.35; 

B  10  10  89.31; 

B  10  10  89.31; 

L  CG; 

B  4  4  4.24; 

B  4  4  22.36; 

B  4  4  22.22; 

B  4  4  37,29; 

B  4  4  57,35; 

B  4  4  89,31; 

B  4  4  89.31; 

(END  WIRE  OEFIMITIOMS); 

(START  VIA  DEFINITIONS) 
(END  VIA  DEFINITIONS); 

(START  CALL  STATEMENTS) 
(END  CALL  STATEMENTS); 

(START  ITER  STATEMENTS) 
(END  ITER  STATEMENTS); 
(bounds  SUB  0,2  135,64) 
OF; 

C  4888  T  0,-2; 


8 


OS  19942  50  1; 

(TITLE  BINBOUT  19942); 

(START  PORT  DEFINITIONS); 

(END  PORT  DEFINITIONS); 

(START  RECTANGLE  DEFINITIONS); 

(END  RECTANGLE  DEFINITIONS); 

(START  WIRE  DEFINITIONS); 

(Mire  0.26  F  M4  fl70  u24  ); 

(Hire  6.40  S  H4  d22  ); 

(Mire  22.44  F  W4  d8  f66  u8  ); 

(Hire  26.40  S  W6  d22  ); 

(Hire  52.40  S  W8  d22  ); 

(Hire  72.40  S  H4  d22  ); 

(Hire  77.100  F  H4  f212  ); 

(Hire  84.91  D  H14  b22  ); 

(Wire  129.40  S  H4  d22  ); 

(Mire  155.44  S  M4  d4  f26  F  f96  u6  ) 
(Hire  197.40  S  H8  d22  ); 

(Wire  215.40  S  H8  d22  ); 

(Wire  229.40  S  H4  d24  ); 

(Mire  263.48  0  H8  dl8  F  M4  d4  f26  ) 
(Mire  279,34  S  H4  dl8  ); 

L  CM* 

B  170  4  85,26; 

B  4  8  22,40; 

B  68  4  54,36; 

B  212  4  183,100; 

B  4  10  88,39; 

B  4  26  170,37; 

B  96  4  229,40; 

B  4  4  263,28; 

B  28  4  275,26; 

B  4  8  277,42; 

L  CM2; 

B  4  22  6,29; 

B  8  22  26,29; 

B  8  22  52,29; 

B  4  22  72,29; 

B  4  22  129,29; 

B  4  4  155,42; 

B  28  4  167,40; 

B  8  22  197,29; 

B  8  22  215,29; 

B  4  24  229,28; 

B  4  18  279,25; 

L  CD; 

B  22  14  73,91; 

B  8  18  263,39; 
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L  CM; 

B  8  8  181,40; 

L  CH2; 

B  8  8  181,40; 

L  CC; 

B  4  4  181,40; 

L  CH; 

B  8  8  263,30; 

L  CD; 

B  8  8  263,30; 

L  CV; 

B  4  4  263,30; 

(END  WIRE  DEFINITIONS); 

(START  VIA  DEFINITIONS); 

(END  VIA  DEFINITIONS); 

(START  CALL  STATEMENTS); 

(Call  MEM  0,40  bounds  0,0  78,64); 

C  4139  T  0,40; 

(Call  SUB  84,40  bounds  0,2  135,64); 
C  4888  T  84,38; 

(Call  MASK  223,34  bounds  0,0  60,66) 
C  32077  T  223,34; 

(END  CALL  STATEMENTS); 

(START  ITER  STATEMENTS); 

(END  ITER  STATEMENTS); 

(bounds  BINBOUT  0,16  289.104); 

OF; 

C  19942  T  0,-16; 


DS  32392  50  1; 
(TITLE  MEM2  32392); 


(START  PORT  DEFINITIONS); 

(END  PORT  DEFINITIONS); 

(START  RECTANGLE  DEFINITIONS); 
(END  RECTANGLE  DEFINITIONS); 

(START  WIRE  DEFINITIONS); 

(END  WIRE  DEFINITIONS); 

(START  VIA  DEFINITIONS); 

(END  VIA  DEFINITIONS); 


(START  CALL  STATEMENTS); 

(END  CALL  STATEMENTS); 

(START  ITER  STATEMENTS); 

(Iter  BINBOUT  1.2  289,85  0.0  bounds  0.0  0.0) 
C  19942  T  0.0; 

C  19942  T  0,85; 

(END  ITER  STATEMENTS); 

(bounds  MEM2  0.0  0,85); 

OF; 

C  32392  T  0.0; 


DS  32398  50  1; 

(TITLE  HEMS  32398); 

(START  PORT  DEFINITIONS); 

(END  PORT  DEFINITIONS); 

(START  RECTANGLE  DEFINITIONS); 

(END  RECTANGLE  DEFINITIONS); 

(START  MIRE  DEFINITIONS); 

(END  MIRE  DEFINITIONS); 

(START  VIA  DEFINITIONS); 

(END  VIA  DEFINITIONS); 

(START  CALL  STATEMENTS); 

(END  CALL  STATEMENTS); 

(START  ITER  STATEMENTS); 

(Iter  BINBOUT  2.4  289,85  0.0  bounds  0.0  0,0) 
C  19942  T  0,0; 

C  19942  T  0,85; 

C  19942  T  0.170; 

C  19942  T  0,255; 

C  19942  T  289,0; 

C  19942  T  289,85; 

C  19942  T  289.170; 

C  19942  T  289,255; 

(END  ITER  STATEMENTS); 

(bounds  MEM8  0.0  289,255); 

DF; 
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